Function Reference


Retrieves the contents of the specified enhanced-format metafile

#include <WinAPIGdi.au3>
_WinAPI_GetEnhMetaFileBits ( $hEmf, ByRef $pBuffer )


$hEmf Handle to the enhanced metafile.
$pBuffer Returns a pointer to a memory block (buffer) that receives the metafile data.
Optionaly, you can set this parameter to 0 before function call, then the function will allocate the required memory block itself.
Otherwise, it must be a valid memory pointer returned by the _WinAPI_CreateBuffer() function, or by previously calling this function.

Return Value

Success: The number of bytes copied to the buffer.
Failure: 0 and sets the @error flag to non-zero.


After the enhanced-metafile bits are retrieved, they can be used to create a memory-based metafile by calling the _WinAPI_SetEnhMetaFileBits() function.

When you no longer need the buffer allocated by this function, you must call the _WinAPI_FreeMemory() function (do not use any other memory routines) to release occupied memory.


_WinAPI_CreateBuffer, _WinAPI_FreeMemory, _WinAPI_SetEnhMetaFileBits

See Also

Search GetEnhMetaFileBits in MSDN Library.