UID

title

description

helpviewer_keywords

old-location

tech.root

ms.assetid

ms.date

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

req.redist

ms.custom

f1_keywords

dev_langs

topic_type

api_type

api_location

api_name

NF:wingdi.SetMetaFileBitsEx

SetMetaFileBitsEx function (wingdi.h)

The SetMetaFileBitsEx function creates a memory-based Windows-format metafile from the supplied data.

SetMetaFileBitsEx

SetMetaFileBitsEx function [Windows GDI]

_win32_SetMetaFileBitsEx

gdi.setmetafilebitsex

wingdi/SetMetaFileBitsEx

gdi\setmetafilebitsex.htm

gdi

232eeba9-f579-4b5f-a31a-416aeb56a909

12/05/2018

SetMetaFileBitsEx, SetMetaFileBitsEx function [Windows GDI], _win32_SetMetaFileBitsEx, gdi.setmetafilebitsex, wingdi/SetMetaFileBitsEx

wingdi.h

Windows.h

Windows

Windows 2000 Professional [desktop apps only]

Windows 2000 Server [desktop apps only]

Gdi32.lib

Gdi32.dll

Windows

19H1

SetMetaFileBitsEx

wingdi/SetMetaFileBitsEx

c++

APIRef

kbSyntax

DllExport

gdi32.dll

Ext-MS-Win-GDI-Metafile-l1-1-0.dll

Ext-MS-Win-GDI-Metafile-l1-1-1.dll

ext-ms-win-gdi-metafile-l1-1-2.dll

GDI32Full.dll

SetMetaFileBitsEx

SetMetaFileBitsEx function

-description

The SetMetaFileBitsEx function creates a memory-based Windows-format metafile from the supplied data.

Note This function is provided only for compatibility with Windows-format metafiles. Enhanced-format metafiles provide superior functionality and are recommended for new applications. The corresponding function for an enhanced-format metafile is SetEnhMetaFileBits.

-parameters

-param cbBuffer [in]

Specifies the size, in bytes, of the Windows-format metafile.

-param lpData [in]

Pointer to a buffer that contains the Windows-format metafile. (It is assumed that the data was obtained by using the GetMetaFileBitsEx function.)

-returns

If the function succeeds, the return value is a handle to a memory-based Windows-format metafile.

If the function fails, the return value is NULL.

-remarks

To convert a Windows-format metafile into an enhanced-format metafile, use the SetWinMetaFileBits function.

When the application no longer needs the metafile handle returned by SetMetaFileBitsEx, it should delete it by calling the DeleteMetaFile function.