Fungsi GetEnhMetaFileDescriptionA (wingdi.h)
Fungsi GetEnhMetaFileDescription mengambil deskripsi teks opsional dari metafile format yang disempurnakan dan menyalin string ke buffer yang ditentukan.
Sintaks
UINT GetEnhMetaFileDescriptionA(
[in] HENHMETAFILE hemf,
[in] UINT cchBuffer,
[out] LPSTR lpDescription
);
Parameter
[in] hemf
Handel ke metafile yang ditingkatkan.
[in] cchBuffer
Ukuran, dalam karakter, dari buffer untuk menerima data. Hanya banyak karakter ini yang akan disalin.
[out] lpDescription
Penunjuk ke buffer yang menerima deskripsi teks opsional.
Mengembalikan nilai
Jika deskripsi teks opsional ada dan penunjuk buffer adalah NULL, nilai yang dikembalikan adalah panjang string teks, dalam karakter.
Jika deskripsi teks opsional ada dan penunjuk buffer adalah penunjuk yang valid, nilai yang dikembalikan adalah jumlah karakter yang disalin ke dalam buffer.
Jika deskripsi teks opsional tidak ada, nilai yang dikembalikan adalah nol.
Jika fungsi gagal, nilai yang dikembalikan GDI_ERROR.
Keterangan
Deskripsi teks opsional berisi dua string, yang pertama mengidentifikasi aplikasi yang membuat metafile yang ditingkatkan dan yang kedua mengidentifikasi gambar yang terkandung dalam metafile. String dipisahkan oleh karakter null dan dihentikan dengan dua karakter null, misalnya, "XYZ Graphics Editor\0Bald Eagle\0\0" di mana \0 mewakili karakter null.
Di mana argumen teks harus menggunakan karakter Unicode, gunakan fungsi ini sebagai fungsi karakter lebar. Di mana argumen teks harus menggunakan karakter dari kumpulan karakter Windows, gunakan fungsi ini sebagai fungsi ANSI.
Catatan
Header wingdi.h mendefinisikan GetEnhMetaFileDescription sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wingdi.h (sertakan Windows.h) |
| Pustaka | Gdi32.lib |
| DLL | Gdi32.dll |