А что тут непонятного? lpApplicationName - длинный указатель на zero-terminated строку, содержащую имя приложения, lpKeyName - длинный указатель на zero-terminated строку, содержащую имя ключа, lpDefault - длинный указатель на zero-terminated строку, содержащую значение ключа по умолчанию, lpReturnedString - длинный указатель на zero-terminated строку, являющуюся буфером для возвращаемой строки, nSize - ее размер, lpFileName - длинный указатель на zero-terminated строку, содержащую имя ini-файла настроек. Некоторые программы пишут, например, в win.ini свой раздел, а потом читают оттуда свои настройки...

Ответить

Это-ж функция для чтения из INI файла... Посмотри соответствуюшие примеры использующие чтение из ини файла... Там она используется!

Ответить

Platform SDK: Windows System Information

GetPrivateProfileString

The GetPrivateProfileString function retrieves a string from the specified section in an initialization file.

Note  This function is provided only for compatibility with 16-bit Windows-based applications. Applications should store initialization information in the registry.

DWORD GetPrivateProfileString(  LPCTSTR lpAppName,  LPCTSTR lpKeyName,  LPCTSTR lpDefault,  LPTSTR lpReturnedString,  DWORD nSize,  LPCTSTR lpFileName);

Parameters

lpAppName

[in] Pointer to a null-terminated string that specifies the name of the section containing the key name. If this parameter is NULL, the GetPrivateProfileString function copies all section names in the file to the supplied buffer.

lpKeyName

[in] Pointer to the null-terminated string specifying the name of the key whose associated string is to be retrieved. If this parameter is NULL, all key names in the section specified by the lpAppName parameter are copied to the buffer specified by the lpReturnedString parameter.

lpDefault

[in] Pointer to a null-terminated default string. If the lpKeyName key cannot be found in the initialization file, GetPrivateProfileString copies the default string to the lpReturnedString buffer. This parameter cannot be NULL.

Avoid specifying a default string with trailing blank characters. The function inserts a null character in the lpReturnedString buffer to strip any trailing blanks.

Windows Me/98/95:  Although lpDefault is declared as a constant parameter, the system strips any trailing blanks by inserting a null character into the lpDefault string before copying it to the lpReturnedString buffer.

lpReturnedString

[out] Pointer to the buffer that receives the retrieved string.

Windows Me/98/95:  The string cannot contain control characters (character code less than 32). Strings containing control characters may be truncated.

nSize

[in] Size of the buffer pointed to by the lpReturnedString parameter, in TCHARs.

lpFileName

[in] Pointer to a null-terminated string that specifies the name of the initialization file. If this parameter does not contain a full path to the file, the system searches for the file in the Windows directory.

Return Values

The return value is the number of characters copied to the buffer, not including the terminating null character.

If neither lpAppName nor lpKeyName is NULL and the supplied destination buffer is too small to hold the requested string, the string is truncated and followed by a null character, and the return value is equal to nSize minus one.

If either lpAppName or lpKeyName is NULL and the supplied destination buffer is too small to hold all the strings, the last string is truncated and followed by two null characters. In this case, the return value is equal to nSize minus two.

Remarks

The GetPrivateProfileString function searches the specified initialization file for a key that matches the name specified by the lpKeyName parameter under the section heading specified by the lpAppName parameter. If it finds the key, the function copies the corresponding string to the buffer. If the key does not exist, the function copies the default character string specified by the lpDefault parameter. A section in the initialization file must have the following form:

[section]key=string      .      .      .

If lpAppName is NULL, GetPrivateProfileString copies all section names in the specified file to the supplied buffer. If lpKeyName is NULL, the function copies all key names in the specified section to the supplied buffer. An application can use this method to enumerate all of the sections and keys in a file. In either case, each string is followed by a null character and the final string is followed by a second null character. If the supplied destination buffer is too small to hold all the strings, the last string is truncated and followed by two null characters.

If the string associated with lpKeyName is enclosed in single or double quotation marks, the marks are discarded when the GetPrivateProfileString function retrieves the string.

The GetPrivateProfileString function is not case-sensitive; the strings can be a combination of uppercase and lowercase letters.

To retrieve a string from the Win.ini file, use the GetProfileString function.

Windows Server 2003, Windows XP/2000/NT:  Calls to private profile functions may be mapped to the registry instead of to the specified initialization files. This mapping occurs when the initialization file and section are specified in the registry under the following keys:

HKEY_LOCAL_MACHINE\Software\Microsoft\
        Windows NT\CurrentVersion\IniFileMapping

This mapping is likely if an application modifies system-component initialization files, such as Control.ini, System.ini, and Winfile.ini. In these cases, the GetPrivateProfileString function retrieves information from the registry, not from the initialization file; the change in the storage location has no effect on the function's behavior.

The profile functions use the following steps to locate initialization information:

1. Look in the r

   Ответить