Método IVdsService::QueryProviders (vds.h)
[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]
Retorna um objeto de enumeração que contém uma lista dos provedores de hardware e software conhecidos pelo VDS.
Sintaxe
HRESULT QueryProviders(
[in] DWORD masks,
[out] IEnumVdsObject **ppEnum
);
Parâmetros
[in] masks
A máscara do provedor enumerada por VDS_QUERY_PROVIDER_FLAG. Os chamadores podem especificar uma máscara de provedor de software, uma máscara de provedor de hardware ou ambos.
[out] ppEnum
O endereço de um ponteiro de interface IEnumVdsObject que pode ser usado para enumerar os provedores como objetos de provedor. Para obter mais informações, consulte Trabalhando com objetos de enumeração. Os chamadores devem liberar a interface e cada um dos objetos do provedor quando não forem mais necessários chamando o método IUnknown::Release .
Retornar valor
Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.
| Valor/código retornado | Descrição |
|---|---|
|
A enumeração é retornada com êxito. |
|
Falha ao inicializar o VDS. Se um aplicativo chamar esse método antes que o serviço termine de inicializar, o método será bloqueado até que a inicialização seja concluída. Se a inicialização falhar, esse erro será retornado. |
Comentários
Para determinar o tipo de provedor para provedores de hardware, chame o método IVdsHwProviderType2::GetProviderType2 ou o método IVdsHwProviderType::GetProviderType para cada objeto de provedor.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vds.h |
| Biblioteca | Uuid.lib |