GetMetaFileBits

2.x

	HGLOBAL GetMetaFileBits(hmf)
	HMETAFILE hmf;	/* handle of metafile, */

The GetMetaFileBits function returns a handle of the global memory object that contains the specified metafile as a collection of bits. The memory object can be used to determine the size of the metafile or to save the metafile as a file. The memory object should not be modified.

Parameters

hmf

Identifies the memory metafile.

Return Value

The return value is the handle of the global memory object that contains the metafile, if the function is successful. Otherwise, it is NULL.

Comments

The handle contained in the hmf parameter becomes invalid when the GetMetaFileBits function returns, so the returned global memory handle must be used to refer to the metafile.

When it no longer requires a global memory object that is associated with a metafile, an application should remove the object by using the GlobalFree function.