Método IWMDMMetaData::QueryByName (mswmdm.h)

Artículo
03/15/2023

El método QueryByName recupera el valor de una propiedad especificada por nombre.

Sintaxis

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

Parámetros

[in] pwszTagName

Puntero a una cadena terminada en null de caracteres anchos que especifica el nombre de la propiedad. Se da una lista de constantes de nombre de propiedad estándar en Constantes de metadatos.

[out] pType

Valor enumerado WMDM_TAG_DATATYPE que describe el tipo de datos recuperados por pValue.

[out] pValue

Puntero a un puntero a una matriz de bytes que recibe el contenido del valor si el método se realiza correctamente. Windows Media Administrador de dispositivos asigna esta memoria y el autor de la llamada debe liberarla mediante CoTaskMemFree.

[out] pcbLength

Puntero al tamaño, en bytes, de la matriz de bytes ppValue. Si el valor es una cadena, esto incluye el carácter de finalización.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error: