Fungsi DisassociateColorProfileFromDeviceW (icm.h)

Artikel
08/24/2023

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 DisassociateColorProfileFromDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR 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.

Menampilkan 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

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


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

Bagikan melalui