LoadString

从 资源 里加载字符串资源到CString对象里。

函数LoadString声明如下：

WINUSERAPI

int

WINAPI

LoadStringA(

__in_opt HINSTANCE hInstance,

__in UINT uID,

__out_ecount(cchBufferMax) LPSTR lpBuffer,

__in int cchBufferMax);

hInstance是应用程序实例句柄。

uID是资源中的字符串编号。

lpBuffer是接收从资源里拷贝字符串出来的缓冲区。

cchBufferMax是指明缓冲的大小。

参数

hInstance

[in] Handle to an instance of the module whose executable file contains the string resource. To get the handle to the application itself, use GetModuleHandle(NULL).

uID

[in] Specifies the integer identifier of the string to be loaded.

lpBuffer

[out] Pointer to the buffer to receive the string.

nBufferMax

[in] Specifies the size of the buffer, in TCHARs. This refers to bytes for ANSI versions of the function or WCHARs for Unicode versions. The string is truncated and NULL terminated if it is longer than the number of characters specified.

返回值

If the function succeeds, the return value is the number of TCHARs copied into the buffer, not including the terminating NULL character, or zero if the string resource does not exist. To get extended error information, call GetLastError.

说明

Security Alert

Using this function incorrectly can compromise the security of your application. Incorrect use includes specifying the wrong size in the nBufferMax parameter. For example, if lpBuffer points to a buffer szBuffer which is declared as TCHAR szBuffer[100], then sizeof(szBuffer) gives the size of the buffer in bytes, which could lead to a buffer overflow for the Unicode version of the function. Buffer overflow situations are the cause of many security problems in applications. In this case, using sizeof(szBuffer)/sizeof(TCHAR) or sizeof(szBuffer)/sizeof(szBuffer[0]) would give the proper size of the buffer.

Windows 95/98/Me: LoadStringW is supported by the Microsoft Layer for Unicode. To use this, you must add certain files to your application, as outlined in Microsoft Layer for Unicode on Windows 95/98/Me Systems.

系统要求

Minimum DLL Version: user32.dll

Header: Declared in Winuser.h, include Windows.h

Import library: User32.lib

Minimum operating systems: Windows 95, Windows NT 3.1

Unicode: Implemented as ANSI and Unicode versions.