Bagikan melalui

Fungsi AssociateColorProfileWithDeviceW (icm.h)

  • Artikel

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 AssociateColorProfileWithDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR 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 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header icm.h
Pustaka Mscms.lib
DLL Mscms.dll

Lihat juga