DdeCreateStringHandleA 函数 (ddeml.h)

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

语法

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

参数

[in] idInst

类型:DWORD

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

[in] psz

类型: LPTSTR

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

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

要求

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

请参阅

概念性

DdeAccessData

DdeCmpStringHandles

DdeFreeStringHandle

DdeInitialize

DdeKeepStringHandle

DdeQueryString

动态数据交换管理库

引用