IWICComponentInfo::GetFriendlyName 方法 (wincodec.h)
擷取元件的易記名稱,這是元件的人類可讀取顯示名稱。
語法
HRESULT GetFriendlyName(
[in] UINT cchFriendlyName,
[in, out] WCHAR *wzFriendlyName,
[out] UINT *pcchActual
);
參數
[in] cchFriendlyName
類型: UINT
wzFriendlyName 緩衝區的大小。
[in, out] wzFriendlyName
類型: WCHAR*
接收元件易記名稱的指標。 字串的地區設定取決於編解碼器在安裝時寫入登錄的值。 針對內建元件,這些字串一律以英文表示。
[out] pcchActual
類型: UINT*
指標,接收元件易記名稱的實際長度。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
如果 cchFriendlyName 為 0 且 wzFriendlyName 為 NULL,則會在 pccchActual 中傳回必要的緩衝區大小。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincodec.h |
程式庫 | Windowscodecs.lib |
Dll | Windowscodecs.dll |