Funzione CopyEnhMetaFileA (wingdi.h)
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 al 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.
Commenti
Dove gli argomenti di testo devono usare i caratteri Unicode, usare la funzione CopyEnhMetaFile come funzione wide-character. Dove gli argomenti di testo devono usare i caratteri del set di caratteri di Windows, usare questa funzione come funzione ANSI.
Le applicazioni possono usare metafile archiviati in memoria per operazioni temporanee.
Quando l'applicazione non ha più bisogno 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |