Fungsi AssociateColorProfileWithDeviceA (icm.h)
Mengaitkan profil warna tertentu dengan perangkat tertentu.
Catatan
API ini tidak mendukung profil "warna lanjutan" untuk monitor HDR. Gunakan ColorProfileAddDisplayAssociation untuk mengelola profil warna tingkat lanjut.
Sintaks
BOOL AssociateColorProfileWithDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR pDeviceName
);
Parameter
pMachineName
Dicadangkan. Harus NULL. Parameter ini dimaksudkan untuk menunjuk ke nama komputer untuk mengaitkan profil dan perangkat yang ditentukan. Penunjuk NULL menunjukkan komputer lokal.
pProfileName
Menunjuk ke nama file profil yang akan dikaitkan.
pDeviceName
Menunjuk ke nama perangkat yang akan dikaitkan.
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
Fungsi AssociateColorProfileWithDevice akan gagal jika profil belum diinstal pada komputer menggunakan fungsi InstallColorProfileW .
Perhatikan bahwa di bawah Windows (Windows 95 atau yang lebih baru), driver perangkat PostScript untuk printer mengasumsikan model warna CMYK. Oleh karena itu, semua printer PostScript harus menggunakan profil warna CMYK. Windows 2000 tidak memiliki batasan ini.
Jika perangkat yang ditentukan adalah monitor, fungsi ini memperbarui profil default.
Beberapa profil biasanya dikaitkan dengan printer, berdasarkan jenis kertas dan tinta. Tidak ada default. GDI memilih yang terbaik dari profil terkait saat aplikasi Anda membuat konteks perangkat (DC).
Pemindai juga tidak memiliki profil default. Namun, atipikal untuk mengaitkan lebih dari satu profil dengan pemindai.
AssociateColorProfileWithDevice selalu menambahkan profil yang ditentukan ke daftar asosiasi profil per pengguna pengguna saat ini untuk perangkat yang ditentukan. Sebelum menambahkan profil ke daftar, AssociateColorProfileWithDevice menentukan apakah pengguna sebelumnya telah menyatakan keinginan untuk menggunakan daftar asosiasi profil per pengguna untuk perangkat. Jika demikian, Maka AssociateColorProfileWithDevice hanya menambahkan profil yang ditentukan ke daftar asosiasi profil per pengguna yang ada untuk perangkat. Jika tidak, Maka AssociateColorProfileWithDevice membuat daftar asosiasi profil per pengguna baru untuk perangkat dengan menyalin daftar asosiasi di seluruh sistem untuk perangkat tersebut. Kemudian menambahkan profil yang ditentukan ke 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 10 Build 20348 |
| Server minimum yang didukung | Windows 10 Build 20348 |
| Header | icm.h |