OleMetafilePictFromIconAndLabel

指定されたアイコンとラベルが描画されたメタファイルを作成する。

OleMetafilePictFromIconAndLabel hIcon, lpszLabel, lpszSourceFile, iIconIndex

hIcon : [intptr] メタファイルに描画されるアイコンへのハンドル。このパラメータは NULL でもよい。hIcon が NULL の場合、この関数はメタファイルを作成せずに NULL を返す。
lpszLabel : [wstr] アイコンラベル。このパラメータは NULL でもよい。lpszLabel が NULL の場合、結果のメタファイルにはラベルが含まれない。
lpszSourceFile : [wstr] アイコンファイルのパスとファイル名。この文字列はユーザインターフェイスから、またはレジストリから取得できる。このパラメータは NULL でもよい。
iIconIndex : [int] lpszSourceFile で指定されたファイル内のアイコンの位置。ファイル先頭からのバイトオフセットで表される。

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

解説

指定されたアイコンとラベルが描画されたメタファイルを作成する。

[戻り値]
アイコンとラベルを含む METAFILEPICT 構造体へのグローバルハンドル。メタファイルは MM_ANISOTROPIC
マッピングモードを使用する。エラーが発生した場合、返されるハンドルは NULL である。この場合、呼び出し元は GetLastError
を呼び出して詳細情報を取得できる。

[備考]
この関数は OleGetIconOfFile および OleGetIconOfClass から呼び出される。lpszSourceFile
が NULL でなく iIconIndex が 0 でない場合、lpszSourceFile で渡されたソースファイル名と
iIconIndex で渡されたインデックスがコメントレコードとして作成されるメタファイルに追加される。

情報