GetStandardColorSpaceProfileW 函式 (icm.h)
擷取已註冊指定標準 色彩空間的色彩設定檔。
語法
BOOL GetStandardColorSpaceProfileW(
PCWSTR pMachineName,
DWORD dwSCS,
PWSTR pBuffer,
PDWORD pcbSize
);
參數
pMachineName
保留的。 必須是 Null。 此參數旨在指向要取得標準色彩空間設定檔的電腦名稱稱。 Null指標表示本機電腦。
dwSCS
指定要擷取設定檔之標準色彩空間的識別碼值。 此參數的唯一有效值是LCS_sRGB和LCS_WINDOWS_COLOR_SPACE。
pBuffer
要放置設定檔名稱之緩衝區的指標。 如果 為 Null，則呼叫會傳回 TRUE ，且緩衝區的必要大小會放在 pdwSize 中。
pcbSize
包含 pProfileName所指向之緩衝區位元組大小的變數指標。 傳回時，變數包含實際使用或需要的緩衝區大小。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。
備註
如果 pProfileName 所指向的緩衝區是由應用程式動態配置，則應用程式可以呼叫 GetStandardColorSpaceProfile 函式來擷取緩衝區所需的大小。 如果使用pProfileName設定為Null呼叫GetStandardColorSpaceProfile，則會傳回FALSE，而 pdwSize所指向的DWORD將會包含pProfileName所指向之緩衝區所需的位元組數目。 然後，應用程式可以配置緩衝區，並再次呼叫 GetStandardColorSpaceProfile ，並將 pProfileName 設定為緩衝區的位址。
除了國際色彩聯盟 ( () 設定檔之外，此函式還支援 Windows Color System (WCS) 裝置模型設定檔 (DMP) 。 它不支援 WCS CAMP 或 GMMP 設定檔，如果使用這類設定檔，則會傳回錯誤。
Windows Vista 特定功能概觀
除了 ICC 設定檔之外，這也會支援 WCS DMP。 它不支援 WCS CAMP 或 GMMP 設定檔，如果這類設定檔搭配此 API 使用，則會傳回錯誤。
每個使用者/LUA 支援
這會擷取針對目前使用者所指定標準色彩空間註冊的色彩設定檔。 如果目前使用者沒有這類設定，則會擷取整個系統設定。
這會使用 WcsGetDefaultColorProfile 搭配 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER。
這是 LUA 內容中的可執行檔。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |