Método IWMDMMetaData::QueryByName (mswmdm.h)
O método QueryByName recupera o valor de uma propriedade especificada por name.
Sintaxe
HRESULT QueryByName(
[in] LPCWSTR pwszTagName,
[out] WMDM_TAG_DATATYPE *pType,
[out] BYTE **pValue,
[out] UINT *pcbLength
);
Parâmetros
[in] pwszTagName
Ponteiro para uma cadeia de caracteres largos terminada em nulo especificando o nome da propriedade. Uma lista de constantes de nome de propriedade padrão é fornecida em Constantes de Metadados.
[out] pType
Um WMDM_TAG_DATATYPE valor enumerado que descreve o tipo de dados recuperados por pValue.
[out] pValue
Ponteiro para um ponteiro para uma matriz de bytes que recebe o conteúdo do valor se o método for bem-sucedido. O Windows Media Gerenciador de Dispositivos aloca essa memória 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:
- Códigos de erro COM padrão
- Códigos de erro do Windows convertidos em valores HRESULT
- Códigos de erro do Windows Media Gerenciador de Dispositivos
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |