Fungsi GetColorDirectoryA (icm.h)
Catatan
API ini mungkin tidak tersedia dalam rilis mendatang. Kami mendorong perangkat lunak baru dan yang sudah ada untuk menggunakan API lain untuk interaksi profil warna. Silakan lihat tabel di bawah ini untuk beberapa contoh.
| Skenario | Mekanisme |
|---|---|
| Menghitung semua profil yang terinstal | Gunakan WcsEnumColorProfilesSize dan WcsEnumColorProfiles, atau EnumColorProfilesA |
| Menginstal/Menghapus instalan profil warna | Gunakan InstallColorProfileA/UninstallColorProfileA |
| Membuka file profil warna secara langsung | Gunakan OpenColorProfileA dengan dwType=PROFILE_FILENAME dalam parameter struct PROFILE. Atau gunakan WcsOpenColorProfileA. Icm.h berisi banyak API yang menerima HPROFILE yang dikembalikan untuk manipulasi profil warna |
Mengambil jalur direktori Windows COLOR pada komputer tertentu.
Sintaks
BOOL GetColorDirectoryA(
PCSTR pMachineName,
PSTR pBuffer,
PDWORD pdwSize
);
Parameter
pMachineName
Dipesan; harus NULL. Parameter ini dimaksudkan untuk menunjuk ke nama komputer tempat profil akan diinstal. Penunjuk NULL menunjukkan komputer lokal.
pBuffer
Menunjuk ke buffer tempat jalur direktori warna akan ditempatkan.
pdwSize
Menunjuk ke variabel yang berisi ukuran dalam byte buffer yang diacu oleh pBuffer. Saat dikembalikan, variabel berisi ukuran buffer yang benar-benar digunakan atau diperlukan.
Mengembalikan nilai
Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Dukungan per pengguna/LUA
Direktori warna masih di seluruh sistem. Fungsi ini dapat dieksekusi dalam konteks LUA.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | icm.h |
| Pustaka | Mscms.lib |
| DLL | Mscms.dll |