Fungsi DisassociateColorProfileFromDeviceA (icm.h)
Memisahkan profil warna tertentu dengan perangkat tertentu pada komputer tertentu.
Catatan
API ini tidak mendukung profil "warna lanjutan" untuk monitor HDR. Gunakan ColorProfileRemoveDisplayAssociation untuk mengelola profil warna tingkat lanjut.
Sintaks
BOOL DisassociateColorProfileFromDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR pDeviceName
);
Parameter
pMachineName
Dicadangkan. Harus NULL. Parameter ini dimaksudkan untuk menunjuk ke nama komputer untuk memisahkan profil dan perangkat yang ditentukan. Penunjuk NULL menunjukkan komputer lokal.
pProfileName
Arahkan ke nama file profil untuk memisahkan.
pDeviceName
Arahkan ke nama perangkat untuk memisahkan.
Nilai kembali
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
Jika lebih dari satu profil dikaitkan dengan perangkat, WCS menggunakan profil terakhir yang terkait sebagai default. Artinya, jika aplikasi Anda secara berurutan mengaitkan tiga profil dengan perangkat, WCS akan menggunakan yang terakhir yang terkait sebagai default. Jika aplikasi Anda kemudian memanggil fungsi DisassociateColorProfileFromDevice untuk memisahkan profil ketiga (yang merupakan default dalam contoh ini), WCS akan menggunakan profil kedua sebagai default.
Jika aplikasi Anda memisahkan semua profil dari perangkat, WCS menggunakan profil sRGB sebagai default.
DisassociateColorProfileFromDevice selalu menghapus profil yang ditentukan dari daftar asosiasi profil per pengguna pengguna saat ini untuk perangkat yang ditentukan. Sebelum menghapus profil dari daftar, DisassociateColorProfileFromDevice menentukan apakah pengguna sebelumnya telah menyatakan keinginan untuk menggunakan daftar asosiasi profil per pengguna untuk perangkat. Jika demikian, maka DisassociateColorProfileFromDevice hanya menghapus profil yang ditentukan dari daftar asosiasi profil per pengguna yang ada untuk perangkat. Jika tidak, maka DisassociateColorProfileFromDevice membuat daftar asosiasi profil per pengguna baru untuk perangkat dengan menyalin daftar asosiasi di seluruh sistem untuk perangkat tersebut. Kemudian menghapus profil yang ditentukan dari daftar per pengguna. Sejak saat itu, pengguna saat ini akan menggunakan daftar asosiasi profil per pengguna untuk perangkat yang ditentukan, seolah-olah WcsSetUsePerUserProfiles telah dipanggil untuk pDevice dengan parameter usePerUserProfiles diatur ke TRUE.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 |