DdeQueryStringW 函式（ddeml.h）

發行項
11/20/2024

將與字串句柄相關聯的文字複製到緩衝區。

語法

DWORD DdeQueryStringW(
  [in]            DWORD  idInst,
  [in]            HSZ    hsz,
  [out, optional] LPWSTR 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 標頭會根據 UNICODE 預處理器常數的定義，將 DdeQueryString 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	ddeml.h （包括 Windows.h）
連結庫	User32.lib
DLL	User32.dll