GetEnhMetaFileBits
The GetEnhMetaFileBits
function retrieves the contents of the specified enhanced-format metafile and
copies them into a buffer.
UINT GetEnhMetaFileBits(
|
HENHMETAFILE hemf, |
// handle of
metafile |
|
UINT cbBuffer, |
// size of data
buffer, in bytes |
|
LPBYTE lpbBuffer |
// address of data buffer
|
|
); |
|
Parameters
hemf
Identifies
the enhanced metafile.
cbBuffer
Specifies the
size, in bytes, of the buffer to receive the data.
lpbBuffer
Points to the
buffer to receive the metafile data. The buffer must be sufficiently large to
contain the data. If lpbBuffer is NULL, the function returns the size
necessary to hold the data.
Return Values
If the
function succeeds and the buffer pointer is NULL, the return value is the size
of the enhanced metafile, in bytes.
If the
function succeeds and the buffer pointer is a valid pointer, the return value
is the number of bytes copied to the buffer.
If the
function fails, the return value is zero.
Remarks
After the
enhanced-metafile bits are retrieved, they can be used to create a memory-based
metafile by calling the SetEnhMetaFileBits function.
The GetEnhMetaFileBits
function does not invalidate the enhanced-metafile handle. The application must
call the DeleteEnhMetaFile function to delete the handle when it is no
longer needed.
The metafile
contents retrieved by this function are in the enhanced format. To retrieve the
metafile contents in the Windows format, use the GetWinMetaFileBits
function.
See Also