GetColorDirectoryW 函式 (icm.h)

注意

未來版本可能無法使用此 API。我們鼓勵新的和現有的軟體使用其他 API 來進行色彩配置文件互動。如需一些範例，請參閱下表。

案例	機制
列舉所有已安裝的配置檔	使用 WcsEnumColorProfilesSize 和 WcsEnumColorProfiles 或 EnumColorProfilesW
安裝/卸載色彩配置檔	使用 InstallColorProfileW/UninstallColorProfileW
直接開啟色彩配置檔案	在 PROFILE 結構參數中使用 OpenColorProfileW 搭配 dwType=PROFILE_FILENAME。或使用 WcsOpenColorProfileW。 Icm.h 包含許多 API，可接受傳回的 HPROFILE 進行色彩配置檔操作

擷取指定電腦上 Windows COLOR 目錄的路徑。

語法

BOOL GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  pBuffer,
  PDWORD pdwSize
);

pMachineName

保留;必須是 NULL。此參數旨在指向要安裝配置檔的計算機名稱。 NULL 指標表示本機計算機。

pBuffer

指向要放置色彩目錄路徑的緩衝區。

pdwSize

指向包含 pBuffer 所指向之緩衝區位元組大小的變數。傳回時，變數包含實際使用或需要的緩衝區大小。

如果此函式成功，則傳回值為 TRUE。

如果此函式失敗，則傳回值為 FALSE。如需擴充錯誤資訊，請呼叫 GetLastError。

每個使用者/LUA 支援

色彩目錄仍為全系統。此函式在 LUA 內容中是可執行的。