Funzione GetEnhMetaFileW (wingdi.h)

Articolo
11/20/2024

La funzione GetEnhMetaFile crea un handle che identifica il metafile in formato avanzato archiviato nel file specificato.

Sintassi

HENHMETAFILE GetEnhMetaFileW(
  [in] LPCWSTR lpName
);

Parametri

[in] lpName

Puntatore a una stringa con terminazione Null che specifica il nome di un metafile avanzato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il metafile avanzato.

Se la funzione ha esito negativo, il valore restituito è NULL.

Osservazioni

Quando l'applicazione non richiede più un handle di metafile avanzato, deve eliminare l'handle chiamando la funzione DeleteEnhMetaFile.

Un metafile in formato Windows deve essere convertito nel formato avanzato prima che possa essere elaborato dalla funzione GetEnhMetaFile. Per convertire il file, usare la funzione setWinMetaFileBits .

Dove gli argomenti di testo devono usare caratteri Unicode, usare questa funzione come funzione a caratteri wide. Dove gli argomenti di testo devono usare caratteri del set di caratteri di Windows, usare questa funzione come funzione ANSI.

Esempi

Per un esempio, vedere Apertura di un metafile avanzato e visualizzazione del relativo contenuto.

Nota

L'intestazione wingdi.h definisce GetEnhMetaFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h (include Windows.h)
libreria	Gdi32.lib
dll	Gdi32.dll