SetEnhMetaFileBits function (wingdi.h)

Article
02/22/2024

The SetEnhMetaFileBits function creates a memory-based enhanced-format metafile from the specified data.

Syntax

HENHMETAFILE SetEnhMetaFileBits(
  [in] UINT       nSize,
  [in] const BYTE *pb
);

Parameters

[in] nSize

Specifies the size, in bytes, of the data provided.

[in] pb

Pointer to a buffer that contains enhanced-metafile data. (It is assumed that the data in the buffer was obtained by calling the GetEnhMetaFileBits function.)

Return value

If the function succeeds, the return value is a handle to a memory-based enhanced metafile.

If the function fails, the return value is NULL.

Remarks

When the application no longer needs the enhanced-metafile handle, it should delete the handle by calling the DeleteEnhMetaFile function.

The SetEnhMetaFileBits function does not accept metafile data in the Windows format. To import Windows-format metafiles, use the SetWinMetaFileBits function.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wingdi.h (include Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll