GetEnhMetaFileBits 関数 (wingdi.h)

GetEnhMetaFileBits 関数は、指定された拡張形式メタファイルの内容を取得し、バッファーにコピーします。

構文

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

[in] hEMF

拡張メタファイルへのハンドル。

[in] nSize

データを受信するバッファーのサイズ (バイト単位)。

[out] lpData

メタファイルデータを受け取るバッファーへのポインター。バッファーは、データを格納するのに十分な大きさである必要があります。 lpbBuffer が NULL の場合、関数はデータを保持するために必要なサイズを返します。

関数が成功し、バッファーポインターが NULL の場合、戻り値は拡張メタファイルのサイズ (バイト単位) です。

関数が成功し、バッファーポインターが有効なポインターである場合、戻り値はバッファーにコピーされたバイト数です。

関数が失敗した場合は、0 を返します。

拡張メタファイルビットを取得した後、 SetEnhMetaFileBits 関数を呼び出してメモリベースのメタファイルを作成できます。

GetEnhMetaFileBits 関数は、拡張メタファイルハンドルを無効にしません。不要になったハンドルを削除するには、アプリケーションで DeleteEnhMetaFile 関数を呼び出す必要があります。

この関数によって取得されるメタファイルの内容は、拡張形式です。 Windows 形式でメタファイルの内容を取得するには、 GetWinMetaFileBits 関数を使用します。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll