Compartilhar via

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

  • Artigo

O método GetSpecifiedMetadata recupera apenas o objeto de metadados especificado para um armazenamento.

Sintaxe

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

Parâmetros

[in] cProperties

Contagem de propriedades a serem recuperadas.

[in] ppwszPropNames

Matriz que contém os nomes de propriedade a serem recuperados. O tamanho dessa matriz deve ser igual a cProperties.

[out] pMetadata

Ponteiro para o ponteiro de interface IWMDMMetaData retornado.

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
Para obter uma lista abrangente 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. O cliente pode especificar os nomes de propriedade para as propriedades que o cliente precisa recuperar.

Por outro lado, o método GetMetadata recupera todos os metadados de armazenamento (propriedades).

Se nenhuma das propriedades especificadas puder ser retornada, o provedor de serviços deverá retornar WMDM_E_NOTSUPPORTED ou qualquer código de erro adequado.

Se pelo menos uma propriedade puder ser recuperada, o provedor de serviços deverá retornar essa propriedade e definir o código de retorno como um código de êxito de WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IMDSPStorage4 Interface