GetMetaFile

The GetMetaFile function creates a handle for the specified metafile.

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.

Parameters

lpszFile

Points to the null-terminated string that specifies the name of a windows-format metafile. (The metafile must already exist.)

Return Value

The return value identifies a windows-format metafile if the function is successful. Otherwise, it is NULL.

Comments

An application can convert a windows-format metafile into a enhanced-format metafile by calling the SetWinMetaFileBits function.

When the application no longer needs the handle returned by GetMetaFile, it should call the DeleteMetaFile function.

The GetMetaFile function may be used as either a wide-character function (where text arguments must use Unicode) or an ANSI function (where text arguments must use characters from the Windows 3.x character set).

See Also

DeleteMetaFile SetWinMetaFileBits