GetMetaFileBitsEx

UINT GetMetaFileBitsEx(hmf, nSize, lpvData)
HMETAFILE hmf;	/* handle of metafile	*/
UINT nSize;	/* size of metafile in bytes	*/
LPVOID lpvData;	/* address of metafile data	*/

The GetMetaFileBitsEx function retrieves the contents of a windows-format metafile and copies them into the buffer at which lpvData points.

Parameters

hmf

Identifies a windows-format metafile.

nSize

Specifies the size, in bytes, of the buffer that receives the data. Only this many bytes will be written.

lpvData

Points to the buffer that receives the metafile data. The buffer must be sufficiently large to contain the data. If this pointer is NULL, the function returns the number of bytes required for the buffer.

Return Value

If lpvData is NULL and the function is successful, the return value specifies the number of bytes required for the buffer; if lpvData is a valid pointer and the function is successful, the return value specifies the total number of bytes copied. It is 0 if an error occurred.

Comments

This function is provided for compatibility purposes only. A windows-format metafile does not support the new curve, path, and transformation functions such as PolyBezier, BeginPath, and SetWorldTransform. Applications that use these new functions and use metafiles to store pictures created by these functions should call the enhanced-format metafile-functions instead.

An application can convert a windows-format metafile into a enhanced-format metafile by calling the SetWinMetaFileBits function.

The handle, hmf, becomes invalid when the GetMetaFileBitsEx function returns.