GetEnhMetaFileHeader

UINT GetEnhMetaFileHeader(hemf, cbBuffer, lpemh)
HENHMETAFILE hemf;	/* handle of enhanced metafile	*/
UINT cbBuffer;	/* size of buffer in bytes	*/
LPENHMETAHEADER lpemh;	/* address of buffer that receives data	*/

The GetEnhMetaFileHeader function retrieves the record which contains the header for the enhanced metafile identified by hemf.

Parameters

hemf

Identifies the enhanced metafile for which the header is retrieved.

cbBuffer

Specifies the number of bytes to be read. Only this many bytes will be written.

lpemh

Points to a ENHMETAHEADER structure that receives the header record. If NULL, the function returns the size of the header record.

Return Value

If lpemh is NULL, the return value specifies the size of the record which contains the header; if lpemh is a valid pointer, the return value specifies the number of bytes copied. Otherwise it is 0.

Comments

An enhanced metafile header contains information such as the metafile's size in bytes, the dimensions of the picture stored in the metafile, the number of records stored in the metafile, the offset to the optional text description, the offset to the optional color palette, the size of the optional color palette, and the resolution of the device upon which the picture was created.

The record which contains the enhanced metafile header is always the first record in the metafile.