SetMetaFileBits

2.x

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

The SetMetaFileBits function creates a memory metafile from the data in the given global memory object.

Parameters

hmf

Identifies the global memory object that contains the metafile data. The object must have been created by a previous call to the GetMetaFileBits function.

Return Value

The return value is the handle of a memory metafile, if the function is successful. Otherwise, it is NULL.

Comments

After the SetMetaFileBits function returns, the metafile handle it returns must be used instead of the hmf handle to refer to the metafile. If SetMetaFileBits is successful, the application should not use or free the memory handle specified by the hmf parameter, because that handle is reused by Windows.

When the application no longer needs the metafile header, it should free the handle by calling the DeleteMetaFile function.

See Also

GetMetaFileBits, GlobalFree