PlayMetaFileRecord

	BOOL PlayMetaFileRecord(hdc, lpHandletable, lpMetaRecord, nHandles)
	HDC hdc;
	LPHANDLETABLE lpHandletable;
	LPMETARECORD lpMetaRecord;
	UINT nHandles;

The PlayMetaFileRecord function plays a Windows metafile record by executing the GDI function that is contained within that record.

Parameters

hdc

Identifies a device context.

lpHandletable

Points to a table of handles that identify GDI objects which are used when playing the metafile.

lpMetaRecord

Points to the windows-format metafile record.

nHandles

Specifies the number of handles in the handle table.

Return Value

The return value is TRUE if the function is successful. Otherwise, it is FALSE.

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.

An application typically uses this function in conjunction with the EnumMetaFile function to process and play a windows-format metafile one record at a time.

The lpHandletable, and nHandles parameters must be identical to those passed to the MetaFunc callback procedure by EnumMetaFile.

If the PlayMetaFileRecord function does not recognize a record, it will ignore the record and return TRUE.