GetEnhMetaFileW

GetEnhMetaFile 関数は、指定ファイルに格納された拡張形式メタファイルを識別するハンドルを作成する。(Unicode)

GetEnhMetaFileW lpName

lpName : [wstr] 拡張メタファイルの名前を指定する NULL 終端文字列へのポインタ。

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

解説

GetEnhMetaFile 関数は、指定ファイルに格納された拡張形式メタファイルを識別するハンドルを作成する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は拡張メタファイルのハンドルである。失敗した場合は NULL である。

[備考]
アプリケーションが拡張メタファイルハンドルを不要になったら、DeleteEnhMetaFile
関数を呼び出してハンドルを削除する必要がある。GetEnhMetaFile 関数で処理するには、Windows
形式メタファイルを拡張形式に変換しておかなければならない。ファイルを変換するには SetWinMetaFileBits
関数を使用する。テキスト引数に Unicode 文字を使う必要がある場合はワイド文字版として、Windows
文字セットを使う必要がある場合は ANSI 版として使用する。

情報

プラグイン / モジュールgdi32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の gdi32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_gdi32_gen2.hs