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