Compartilhar via

Método IMDSPStorage2::GetStorage (mswmdm.h)

  • Artigo

O método GetStorage possibilita ir diretamente para um objeto de armazenamento de um nome de armazenamento em vez de enumerar em todos os armazenamentos para encontrá-lo.

Sintaxe

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

Parâmetros

[in] pszStorageName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome de armazenamento.

[out] ppStorage

Ponteiro para o objeto de armazenamento especificado por pszStorageName ou NULL se nenhum armazenamento desse tipo foi encontrado.

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

A interface IMDSPStorage2::GetStorage estende a funcionalidade do IMDSPStorage.

IMDSPStorage2::GetStorage não dá suporte a caracteres curinga. Ele não é recursivo, ou seja, só encontrará objetos de armazenamento no armazenamento atual.

Se esse método não for implementado, ele deverá retornar E_NOTIMPL. (Ele não deve retornar WMDM_E_NOT_SUPPORTED ou quaisquer outros códigos que indiquem que esse método não está implementado). Isso garantirá que o Windows Media Gerenciador de Dispositivos tentará substituir essa própria funcionalidade enumerando todos os armazenamentos para encontrar uma correspondência com base no nome de armazenamento passado como pszStorageName.

É altamente recomendável que um provedor de serviços implemente esse método para retornar com eficiência um objeto de armazenamento com base no nome.

Esse método é opcional. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Requisitos

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

Confira também

IMDSPStorage Interface

IMDSPStorage2 Interface