DdeQueryStringA 函数（ddeml.h）

项目
11/20/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 [仅限桌面应用]
目标平台	窗户
标头	ddeml.h （包括 Windows.h）
库	User32.lib
DLL	User32.dll