GetEnhMetaFile

  HENHMETAFILE GetEnhMetaFile(lpszMetaFile)    
  LPTSTR lpszMetaFile; /* address of metafile name */

The GetEnhMetaFile function creates a handle that identifies the enhanced metafile which is stored in the specified file.

Parameters

lpszMetaFile

Points to a null-terminated filename that contains the enhanced metafile.

Return Value

The return value identifies the enhanced metafile if the function is successful. Otherwise, it is NULL.

Comments

When the application no longer needs an enhanced metafile handle, it should call the DeleteEnhMetaFile function.

A Windows-format metafile must be converted to the enhanced format (by calling SetWinMetaFileBits) before it can be processed by the GetEnhMetaFile function.

This 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