Método IMDSPStorage2::GetStorage (mswmdm.h)
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
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 |