MFC常用函数-CSDN博客

2019独角兽企业重金招聘Python工程师标准>>>

1 GetModuleFileName()

函数原型

 DWORDGetModuleFileName( 
 HMODULEhModule, 
 LPTSTRlpFilename, 
 DWORDnSize 
 ); 

函数参数

HMODULE hModule 装载一个程序实例的句柄。如果该参数为NULL，该函数返回该当前应用程序全路径。

LPTSTR lpFileName 是你存放返回的名字的内存块的指针，是一个输出参数

DWORD nSize，装载到缓冲区lpFileName的最大值

函数返回值

如果返回为成功，将在lpFileName的缓冲区当中返回相应模块的路径，如果所设的nSize过小，那么返回仅按所设置缓冲区大小返回相应字符串内容。

如果函数失败，返回值将为0，利用GetLastError可获得异常代码。

头文件

windows.h

2 GetPrivateProfileString()

函数原型

DWORD GetPrivateProfileString(lpszSection, lpszKey, lpszDefault,lpReturnedString, cchReturnBuffer, lpszFile)

Retrieves a string from the specified section in an initialization file.

从一个初始化文件中的指定的小节中获取一个字符串

函数参数

参数类型及说明

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

lpAppName [in] 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] 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] A default string. If the lpKeyName key cannot be found in the initialization file, GetPrivateProfileString copies the default string to the lpReturnedString buffer. If this parameter is NULL, the default is an empty string, "".

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

lpReturnedString [out] A pointer to the buffer that receives the retrieved string.

nSize [in] The size of the buffer pointed to by the lpReturnedString parameter, in characters.

lpFileName [in] 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.

函数返回值

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 anull 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 nullcharacters. In this case, the return value is equal to nSize minus two.

In the event the initialization file specified by lpFileName is not found, or contains invalid values, this function will set errorno with a value of '0x2' (File Not Found). To retrieve extended error information, call GetLastError.