DdeQueryStringA 函数 (ddeml.h)

项目
02/26/2024

将与字符串句柄关联的文本复制到缓冲区中。

语法

DWORD DdeQueryStringA(
  [in]            DWORD idInst,
  [in]            HSZ   hsz,
  [out, optional] LPSTR psz,
  [in]            DWORD cchMax,
  [in]            int   iCodePage
);

参数

[in] idInst

类型：DWORD

上一次调用 DdeInitialize 函数时获取的应用程序实例标识符。

[in] hsz

类型： HSZ

要复制的字符串的句柄。此句柄必须是先前对 DdeCreateStringHandle 函数的调用创建的。

[out, optional] psz

类型： LPTSTR

指向接收字符串的缓冲区的指针。若要获取字符串的长度，此参数应设置为 NULL。

[in] cchMax

类型：DWORD

psz 参数指向的缓冲区的长度（以字符为单位）。对于函数的 ANSI 版本，这是字节数;对于 Unicode 版本，这是字符数。如果字符串长于 cchMax– 1 () ，则将被截断。如果 psz 参数设置为 NULL，则忽略此参数。

[in] iCodePage

类型： int

用于呈现字符串的代码页。此值应 为CP_WINANSI 或 CP_WINUNICODE。

返回值

类型：DWORD

如果 psz 参数指定了有效的指针，则返回值是返回的文本的长度（以字符为单位）， (不包括终止 null 字符) 。如果 psz 参数指定 了 NULL 指针，则返回值为与 hsz 参数关联的文本的长度， (不包括终止 null 字符) 。如果发生错误，则返回值为 0L。

注解

缓冲区中返回的字符串始终以 null 结尾。如果字符串长于 ( cchMax– 1) ，则仅复制字符串的前 ( cchMax – 1) 个字符。

如果 psz 参数为 NULL， 则 DdeQueryString 函数获取与字符串句柄关联的字符串的长度（以字节为单位）。长度不包括终止 null 字符。

注意

ddeml.h 标头将 DdeQueryString 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	ddeml.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll