# Function Reference

# _WinAPI_GetEnhMetaFileBits

Retrieves the contents of the specified enhanced-format metafile

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

## Parameters

$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.

## Remarks

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.

## Related

_WinAPI_CreateBuffer, _WinAPI_FreeMemory, _WinAPI_SetEnhMetaFileBits

## See Also

Search GetEnhMetaFileBits in MSDN Library.