WritePrivateProfileString、GetPrivateProfileString 读写配置文件

WritePrivateProfileString 写配置文件

  BOOL WINAPI WritePrivateProfileString(
    _In_ LPCTSTR lpAppName,
    _In_ LPCTSTR lpKeyName,
    _In_ LPCTSTR lpString,
    _In_ LPCTSTR lpFileName
  );

  参数：
    lpAppName：
      要复制字符串的部分的名称。如果该部分不存在，则创建它。该部分的名称与大小写无关; 字符串可以是大写和小写字母的任意组合。
    lpKeyName：
      与字符串关联的键的名称。如果该键在指定的部分不存在，则创建它。如果此参数为NULL，则整个部分（包括该部分中的所有条目）将被删除。
    lpString：
      一个零结尾的字符串写入文件。如果此参数为NULL，则lpKeyName参数指向的键将被删除。
    lpFileName：
      初始化文件的名称。如果文件是使用Unicode字符创建的，则该函数将Unicode字符写入该文件。否则，函数写入ANSI字符。

  返回值：
    如果函数成功将字符串复制到初始化文件，则返回值不为零。如果函数失败，或者刷新最近访问的初始化文件的缓存版本，返回值为零。要获取扩展错误信息，请调用 GetLastError。

  注意：
    初始化文件中的一个部分必须具有以下形式:
    [section]
    key=string
      .
      .
      .

  如果lpFileName参数不包含文件的完整路径和文件名， WritePrivateProfileString会在Windows目录中搜索该文件。如果该文件不存在，则此功能将在Windows目录中创建该文件。
  如果lpFileName包含完整路径和文件名，并且该文件不存在，则 WritePrivateProfileString将创建该文件。指定的目录必须已经存在。

GetPrivateProfileString 读取配置文件

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

  参数：
    lpAppName [in]
      包含密钥名称的部分的名称。如果此参数为NULL，则 GetPrivateProfileString函数将文件中的所有段名复制到提供的缓冲区。
    lpKeyName [in]
      要检索其关联字符串的键的名称。如果此参数为NULL，则由lpAppName参数指定的部分中的所有键名将复制到由lpReturnedString参数指定的缓冲区中。
    lpDefault [in]
      默认字符串。如果在初始化文件中找不到lpKeyName键，则 GetPrivateProfileString将默认字符串复制到lpReturnedString缓冲区。如果此参数为NULL，则默认值为空字符串“”。
      避免指定一个带有空白字符的默认字符串。该函数在lpReturnedString缓冲区中插入一个空字符以去除任何尾随的空白。
    lpReturnedString [out]
      指向接收检索字符串的缓冲区的指针。
    nSize [in]
      lpReturnedString参数指向的缓冲区的大小，以字符为单位。
    lpFileName [in]
      初始化文件的名称。如果此参数不包含文件的完整路径，系统将在Windows目录中搜索该文件。

  返回值：
    返回值是复制到缓冲区的字符数，不包括终止空字符。
    如果lpAppName和lpKeyName都不为NULL，并且提供的目标缓冲区太小而不能容纳所请求的字符串，则该字符串将被截断，后跟一个空字符，返回值等于nSize减去一个。
    如果lpAppName或lpKeyName为NULL，并且提供的目标缓冲区太小而不能容纳所有字符串，则最后一个字符串将被截断，后跟两个空字符。在这种情况下，返回值等于nSize减去2。
    在没有找到由lpFileName指定的初始化文件或包含无效值的情况下，该函数将设置值为“0x2”（找不到文件）的errorno。要检索扩展错误信息，请调用GetLastError。

查看更多 WritePrivateProfileString

查看更多 GetPrivateProfileString