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

Artigo
03/13/2024

O método QueryByIndex recupera o valor de uma propriedade especificada pelo índice.

Sintaxe

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

Parâmetros

[in] iIndex

Inteiro que especifica o índice baseado em zero da propriedade. O número de itens é obtido por meio da chamada GetItemCount .

[out] ppwszName

Nome da propriedade. O Windows Media Gerenciador de Dispositivos aloca essa memória e o chamador deve liberá-la usando CoTaskMemFree.

[out] pType

Um WMDM_TAG_DATATYPE valor enumerado que descreve o tipo de dados retornados em ppValue.

[out] ppValue

Ponteiro para um ponteiro para uma matriz de bytes que recebe o conteúdo do valor se o método for bem-sucedido. Essa memória é alocada pelo Windows Media Gerenciador de Dispositivos e o chamador deve liberá-la usando CoTaskMemFree.

[out] pcbLength

Ponteiro para o tamanho, em bytes, da matriz de bytes ppValue. Se o valor for uma cadeia de caracteres, isso incluirá o caractere de encerramento.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro: