Funzione CopyEnhMetaFileA (wingdi.h)

Articolo
11/20/2024

La funzione CopyEnhMetaFile copia il contenuto di un metafile di formato avanzato in un file specificato.

Sintassi

HENHMETAFILE CopyEnhMetaFileA(
  [in] HENHMETAFILE hEnh,
  [in] LPCSTR       lpFileName
);

Parametri

[in] hEnh

Handle per il metafile avanzato da copiare.

[in] lpFileName

Puntatore al nome del file di destinazione. Se questo parametro è NULL, il metafile di origine viene copiato in memoria.

Valore restituito

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

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

Osservazioni

Dove gli argomenti di testo devono usare caratteri Unicode, usare la funzione CopyEnhMetaFile 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.

Le applicazioni possono usare metafile archiviati in memoria per le operazioni temporanee.

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

Nota

L'intestazione wingdi.h definisce CopyEnhMetaFile 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

Vedere anche

DeleteEnhMetaFile

funzioni metafile

Panoramica Metafiles

Condividi tramite