GetStandardColorSpaceProfileA 函式 (icm.h)
擷取為指定之標準 色彩空間註冊的色彩設定檔。
語法
BOOL GetStandardColorSpaceProfileA(
PCSTR pMachineName,
DWORD dwSCS,
PSTR pBuffer,
PDWORD pcbSize
);
參數
pMachineName
保留的。 必須是 Null。 此參數旨在指向要取得標準色彩空間設定檔的電腦名稱稱。 Null指標表示本機電腦。
dwSCS
指定要擷取設定檔之標準色彩空間的識別碼值。 此參數的唯一有效值為 LCS_sRGB 和 LCS_WINDOWS_COLOR_SPACE。
pBuffer
要放置設定檔名稱的緩衝區指標。 如果 為 Null，則呼叫會傳回 TRUE ，並將緩衝區的必要大小放在 pdwSize 中。
pcbSize
變數的指標，其中包含 pProfileName所指向之緩衝區的大小，以位元組為單位。 傳回時，變數會包含實際使用或所需的緩衝區大小。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。
備註
如果 pProfileName 指向的緩衝區是由應用程式動態配置，應用程式可以呼叫 GetStandardColorSpaceProfile 函式來擷取緩衝區所需的大小。 如果呼叫 GetStandardColorSpaceProfile並將pProfileName設定為Null，則會傳回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 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |