IWMDMMetaData：：QueryByName 方法 (mswmdm.h)

QueryByName 方法會擷取名稱所指定的屬性值。

語法

HRESULT QueryByName(
  [in]  LPCWSTR           pwszTagName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **pValue,
  [out] UINT              *pcbLength
);

參數

[in] pwszTagName

指定屬性名稱的寬字元 Null 終止字串指標。 元數據常數中會提供標準屬性名稱常數的清單。

[out] pType

描述 pValue 所擷取之數據類型的WMDM_TAG_DATATYPE列舉值。

[out] pValue

當方法成功時，接收值內容的位元組陣列指標指標。 Windows Media 裝置管理員 配置此記憶體，呼叫端必須使用 CoTaskMemFree 釋放它。

[out] pcbLength

位元組數位 陣組 ppValue 的大小指標，以位元組為單位。 如果值為字串，這包含終止字元。

傳回值

方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何一種錯誤碼類別：

• 標準 COM 錯誤碼
• 轉換成 HRESULT 值的 Windows 錯誤碼
• Windows 媒體 裝置管理員 錯誤碼

規格需求

另請參閱

IWMDMMetaData 介面

元數據常數

QueryByIndex

在檔案上設定元數據