共用方式為

GetICMProfileA 函式 （wingdi.h）

  • 發行項

GetICMProfile 函式會擷取指定裝置內容目前輸出色彩配置檔的檔名。

語法

BOOL GetICMProfileA(
  HDC     hdc,
  LPDWORD pBufSize,
  LPSTR   pszFilename
);

參數

hdc

指定要從中擷取色彩配置檔的裝置內容。

pBufSize

DWORD 的指標，其中包含 lpszFilename所指向之緩衝區的大小。 對於此函式的 ANSI 版本，大小是以位元組為單位。 針對 Unicode 版本，大小在 WCHAR 中。 如果此函式成功，則傳回此參數時會包含實際使用的緩衝區大小。 不過，如果緩衝區不夠大，此函式會傳回 FALSE。 在此情況下，GetLastError（） 函式會傳回ERROR_INSUFFICIENT_BUFFER，而此參數所指向的 DWORD 包含 lpszFilename 緩衝區所需的大小。

pszFilename

指向接收配置檔路徑名稱的緩衝區。

傳回值

如果函式成功，則傳回值會 TRUE。 如果 lpszFilename 參數是 NULL，而且緩衝區所需的大小會複製到 l l ，它也會傳 回 TRUE。

如果函式失敗傳回值會 FALSE。

言論

GetICMProfile 會取得目前輸出配置檔的檔名，不論裝置內容是否啟用色彩管理。

假設裝置內容，GetICMProfile 會透過參數 lpszFilename輸出，這是包含裝置內容目前使用之色彩配置檔的檔案路徑名稱。 它也會透過參數 lcpName輸出包含路徑名稱的字串長度。

GetICMProfile 傳回的設定檔名稱 可能不在 EnumICMProfiles所傳回的設定檔清單中。 EnumICMProfiles 函式會傳回與裝置內容 （DC） 相關聯的所有色彩空間配置檔，其設定符合 DC 的色彩空間配置檔。 如果 SetICMProfile 函式用來設定目前的配置檔，則配置檔可能與不符合其設定的 DC 相關聯。 例如，SetICMProfile 函式可用來將裝置獨立的 sRGB 配置檔與 DC 產生關聯。 此配置檔將做為該 DC 的目前 WCS 配置檔，而呼叫 GetICMProfile 會傳回其檔名。 不過，配置檔不會出現在從 EnumICMProfiles 傳回的設定檔案清單中，。

如果在對 SetICMProfile 函式的任何呼叫之前呼叫此函式，它可以用來取得裝置內容的預設配置檔。

Windows 95/98/Me：Unicode Microsoft層支援 GetICMProfileW。 若要使用此功能，您必須將特定檔案新增至您的應用程式，如 Windows 95/98/Me Systems上 Microsoft Layer for Unicode 中所述。

注意

wingdi.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetICMProfile 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wingdi.h
連結庫 Gdi32.lib
DLL Gdi32.dll

另請參閱