Funzione CopyMetaFileA (wingdi.h)
La funzione CopyMetaFile copia il contenuto di un metafile in formato Windows nel file specificato.
Sintassi
HMETAFILE CopyMetaFileA(
[in] HMETAFILE unnamedParam1,
[in] LPCSTR unnamedParam2
);
Parametri
[in] unnamedParam1
Handle per il metafile in formato Windows di origine.
[in] unnamedParam2
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 in formato Windows.
Se la funzione ha esito negativo, il valore restituito è NULL.
Commenti
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.
Quando l'applicazione non necessita più dell'handle metafile in formato Windows, deve eliminare l'handle chiamando la funzione DeleteMetaFile .
Nota
L'intestazione wingdi.h definisce CopyMetaFile 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |