GetPropW

指定したウィンドウのプロパティリストからデータハンドルを取得する。取得するハンドルは文字列によって識別される。文字列とハンドルは事前に SetProp 関数でプロパティリストに追加されていなければならない。(Unicode)

GetPropW hWnd, lpString

hWnd : [intptr] 型: HWND 検索対象のプロパティリストを持つウィンドウへのハンドル。
lpString : [wstr] 型: LPCTSTR 文字列を識別するアトム。アトムの場合、GlobalAddAtom 関数で作成されたものでなければならない。16 ビット値のアトムは lpString の下位ワードに配置し、上位ワードはゼロでなければならない。

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

解説

指定したウィンドウのプロパティリストからデータハンドルを取得する。取得するハンドルは文字列によって識別される。文字列とハンドルは事前に
SetProp 関数でプロパティリストに追加されていなければならない。(Unicode)

[戻り値]
型: HANDLE プロパティリストに文字列が含まれていれば、戻り値は関連付けられたデータハンドルである。それ以外の場合、戻り値は
NULL である。

[備考]
> [!NOTE] > winuser.h ヘッダは GetProp を、UNICODE プリプロセッサ定数の定義に応じて ANSI 版と
Unicode
版を自動選択するエイリアスとして定義する。エンコーディングに依存するコードと、エンコーディング中立なエイリアスの混在は、コンパイルエラーや実行時エラーの原因となる。詳しくは
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報