DdeCreateStringHandleA 函数（ddeml.h）

项目
11/20/2024

创建标识指定字符串的句柄。动态数据交换（DDE）客户端或服务器应用程序可以将字符串句柄作为参数传递给其他动态数据交换管理库（DDEML）函数。

语法

HSZ DdeCreateStringHandleA(
  [in] DWORD  idInst,
  [in] LPCSTR psz,
  [in] int    iCodePage
);

参数

[in] idInst

类型：DWORD

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

[in] psz

类型：LPTSTR

要为其创建句柄的以 null 结尾的字符串。此字符串最多可包含 255 个字符。此限制的原因是使用 atom 实现 DDEML 字符串管理功能。

[in] iCodePage

类型：int

用于呈现字符串的代码页。此值应为 CP_WINANSI（默认代码页）或CP_WINUNICODE，具体取决于客户端应用程序是否调用了 DdeInitialize 的 ANSI 或 Unicode 版本。

返回值

类型：HSZ

如果函数成功，则返回值为字符串句柄。

如果函数失败，则返回值为 0L。

DdeGetLastError 函数可用于获取错误代码，可以是以下值之一：

言论

字符串句柄的值与它标识的字符串大小写无关。

当应用程序创建字符串句柄或接收回调函数中的字符串句柄，然后使用 DdeKeepStringHandle 函数来保留它时，应用程序必须在不再需要该字符串句柄时释放该字符串句柄。

无法将特定于实例的字符串句柄从字符串句柄映射到字符串，也不能映射回字符串句柄。以下示例演示了这一点，其中 DdeQueryString 函数从字符串句柄创建字符串，DdeCreateStringHandle 从该字符串创建字符串句柄，但两个句柄不同：

DWORD idInst; 
DWORD cb; 
HSZ hszInst, hszNew; 
PSZ pszInst; 
 
DdeQueryString(idInst, hszInst, pszInst, cb, CP_WINANSI); 
hszNew = DdeCreateStringHandle(idInst, pszInst, CP_WINANSI); 
// hszNew != hszInst !

注意

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

要求

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