IWICBitmapCodecInfo：：GetFileExtensions 方法 (wincodec.h)

擷取與編解碼器相關聯的擴展名逗號分隔清單。

語法

HRESULT GetFileExtensions(
  [in]      UINT  cchFileExtensions,
  [in, out] WCHAR *wzFileExtensions,
  [in, out] UINT  *pcchActual
);

參數

[in] cchFileExtensions

類型： UINT

擴展名緩衝區的大小。 在第一次呼叫時使用 0 來判斷所需的緩衝區大小。

[in, out] wzFileExtensions

類型： WCHAR*

接收與編解碼器相關聯的擴展名逗號分隔清單。 在第一次呼叫時使用 NULL 來判斷所需的緩衝區大小。

[in, out] pcchActual

類型： UINT*

擷取與編解碼器相關聯的所有擴展名所需的實際緩衝區大小。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

影像編碼器的默認擴充功能是傳回延伸模組清單中的第一個專案。

這個方法的使用模式是兩個呼叫進程。 第一次呼叫會擷取擷取完整色彩管理版本號碼所需的緩衝區大小，方法是呼叫 cchFileExtensions 設為 0 ，並將 wzFileExtensions 設定為 NULL。 此呼叫會將 pcchActual 設定為所需的緩衝區大小。 一旦決定所需的緩衝區大小，第二個 GetFileExtensions 呼叫 會將 cchFileExtensions 設定為緩衝區大小， 而 wzFileExtensions 設定為適當大小的緩衝區將會擷取圖元格式。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	wincodec.h
程式庫	Windowscodecs.lib