Bagikan melalui

Fungsi GetColorDirectoryW (icm.h)

  • Artikel

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 EnumColorProfilesW
Menginstal/Menghapus instalan profil warna Gunakan InstallColorProfileW/UninstallColorProfileW
Membuka file profil warna secara langsung Gunakan OpenColorProfileW dengan dwType=PROFILE_FILENAME dalam parameter struct PROFILE.
Atau gunakan WcsOpenColorProfileW. Icm.h berisi banyak API yang menerima HPROFILE yang dikembalikan untuk manipulasi profil warna

Mengambil jalur direktori Windows COLOR pada komputer tertentu.

Sintaks

BOOL GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  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.

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

Dukungan per pengguna/LUA

Direktori warna masih di seluruh sistem. Fungsi ini dapat dieksekusi dalam konteks LUA.

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

Lihat juga