iWMDMMetaData：：QueryByIndex 方法 (mswmdm.h)

QueryByIndex 方法會擷取索引所指定的屬性值。

語法

HRESULT QueryByIndex(
  [in]  UINT              iIndex,
  [out] WCHAR             **ppwszName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **ppValue,
  [out] UINT              *pcbLength
);

參數

[in] iIndex

指定屬性之以零起始之索引的整數。 項目數目是透過 GetItemCount 呼叫取得。

[out] ppwszName

屬性的名稱。 Windows Media 裝置管理員 配置此記憶體，呼叫端必須使用 CoTaskMemFree 釋放它。

[out] pType

描述 ppValue 中傳回之數據類型的WMDM_TAG_DATATYPE列舉值。

[out] ppValue

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

[out] pcbLength

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

傳回值

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

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

規格需求

另請參閱

GetItemCount

IWMDMMetaData 介面

QueryByName

在檔案上設定元數據