DdeQueryStringW

文字列ハンドルに関連付けられたテキストをバッファにコピーする。(Unicode)

DdeQueryStringW idInst, hsz, psz, cchMax, iCodePage

idInst : [int] 型: DWORD DdeInitialize 関数の以前の呼び出しで取得したアプリケーションインスタンス識別子。
hsz : [intptr] 型: HSZ コピーする文字列へのハンドル。このハンドルは DdeCreateStringHandle 関数の以前の呼び出しで作成されたものでなければならない。
psz : [wstr] 型: LPTSTR 文字列を受け取るバッファへのポインタ。文字列の長さを取得するには、このパラメータを NULL に設定する。
cchMax : [int] 型: DWORD psz パラメータが指すバッファの長さ (文字数)。ANSI 版ではバイト数、Unicode 版では文字数。文字列が (cchMax - 1) より長い場合、切り詰められる。psz が NULL の場合、このパラメータは無視される。
iCodePage : [int] 型: int 文字列のレンダリングに使用するコードページ。CP_WINANSI または CP_WINUNICODE のいずれかを指定する。

(プラグイン / モジュール : user32.dll)

解説

文字列ハンドルに関連付けられたテキストをバッファにコピーする。(Unicode)

[戻り値]
型: DWORD psz が有効なポインタを指定した場合、戻り値は返されたテキストの長さ (文字数、終端 null 文字を除く)。psz
が NULL ポインタを指定した場合、戻り値は hsz パラメータに関連付けられたテキストの長さ (終端 null
文字を除く)。エラーが発生した場合、戻り値は 0L。

[備考]
バッファに返される文字列は常に null 終端される。文字列が (cchMax - 1) より長い場合、最初の (cchMax - 1)
文字のみがコピーされる。psz が NULL の場合、DdeQueryString 関数は文字列ハンドルに関連する文字列の長さ (バイト)
を取得する。長さには終端 null 文字は含まれない。
> [!NOTE] > ddeml.h ヘッダは DdeQueryString をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づき自動的に ANSI/Unicode
版を選択する。エンコーディング非依存のエイリアスとそうでないコードを混在させると、コンパイル時または実行時のエラーにつながる不一致が生じる可能性がある。詳細は
Conventions for Function Prototypes を参照。

情報