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

Artículo
03/13/2024

El método QueryByIndex recupera el valor de una propiedad especificada por índice.

Sintaxis

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

Parámetros

[in] iIndex

Entero que especifica el índice de base cero de la propiedad . El número de elementos se obtiene a través de la llamada GetItemCount .

[out] ppwszName

Nombre de la propiedad. Windows Media Administrador de dispositivos asigna esta memoria y el autor de la llamada debe liberarla con CoTaskMemFree.

[out] pType

Valor enumerado WMDM_TAG_DATATYPE que describe el tipo de datos devueltos en ppValue.

[out] ppValue

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 con 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: