Método IWMDMStorage4::GetSpecifiedMetadata (mswmdm.h)

Artigo
03/05/2024

O método GetSpecifiedMetadata recupera uma ou mais propriedades de metadados específicas do armazenamento.

Sintaxe

HRESULT GetSpecifiedMetadata(
  [in]  DWORD         cProperties,
  [in]  LPCWSTR       *ppwszPropNames,
  [out] IWMDMMetaData **ppMetadata
);

Parâmetros

[in] cProperties

Contagem de propriedades a serem recuperadas.

[in] ppwszPropNames

Matriz de nomes de propriedades a serem recuperados. O comprimento dessa matriz deve ser igual a cProperties. O aplicativo deve liberar essa memória usando CoTaskMemFree.

[out] ppMetadata

Ponteiro para o ponteiro de interface IWMDMetaData retornado, contendo os valores recuperados. O chamador deve liberar essa interface quando terminar com ela.

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 de Gerenciador de Dispositivos do Windows Media

Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Esse método fornece ao cliente controle sobre quais propriedades são recuperadas. Isso pode ser mais eficiente do que IWMDMStorage3::GetMetadata e é recomendado quando o cliente precisa apenas de um subconjunto de propriedades compatíveis com o armazenamento.

Se esse método for usado para recuperar dados de um dispositivo WPD (Dispositivos Portáteis do Windows), os dados serão retornados em forma binária em um objeto IPortableDeviceValues . O aplicativo deve des serializar esses dados para obter os valores de propriedade reais.

O método é bem-sucedido e retorna WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED mesmo que algumas das propriedades especificadas não possam ser recuperadas (mas pelo menos uma propriedade foi recuperada). O método falha e retorna WMDM_E_NOTSUPPORTED se nenhuma das propriedades especificadas puder ser recuperada.

Solicitar uma única propriedade é um caso especial desse método. Se o cliente solicitar uma única propriedade, os possíveis códigos de retorno serão S_OK, E_INVALIDARG e WMDM_E_NOTSUPPORTED. Assim, no caso de uma única propriedade, o método só terá êxito se a propriedade for recuperada com êxito.