GetColorDirectoryA 函式 (icm.h)

注意

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

狀況	機制
列舉所有已安裝的設定檔	使用 WcsEnumColorProfilesSize 和 WcsEnumColorProfiles或 EnumColorProfilesA
安裝/卸載色彩設定檔	使用InstallColorProfileA/UninstallColorProfileA
直接開啟色彩設定檔案	在 PROFILE 結構參數中使用 OpenColorProfileA 搭配 dwType=PROFILE_FILENAME。或使用 WcsOpenColorProfileA。 Icm.h 包含許多 API，可接受傳回的 HPROFILE 進行色彩設定檔操作

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

語法

BOOL GetColorDirectoryA(
  PCSTR  pMachineName,
  PSTR   pBuffer,
  PDWORD pdwSize
);

pMachineName

保留;必須是 Null。此參數旨在指向要安裝設定檔的電腦名稱稱。 Null指標表示本機電腦。

pBuffer

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

pdwSize

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

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

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

每個使用者/LUA 支援

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