Метод IWMDMMetaData::QueryByName (mswmdm.h)

Статья
08/25/2023

Метод QueryByName извлекает значение свойства, указанного по имени.

Синтаксис

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

Параметры

[in] pwszTagName

Указатель на строку с широкими символами, завершающуюся нулевым значением, с указанием имени свойства. Список стандартных констант имен свойств приведен в разделе Константы метаданных.

[out] pType

WMDM_TAG_DATATYPE перечислимое значение, описывающее тип данных, получаемых pValue.

[out] pValue

Указатель на указатель на массив байтов, который получает содержимое значения при успешном выполнении метода. Windows Media диспетчер устройств выделяет эту память, и вызывающий объект должен освободить ее с помощью CoTaskMemFree.

[out] pcbLength

Указатель на размер массива байтов ppValue (в байтах). Если значение является строкой, это включает символ завершения.