Compartilhar via


Método IVdsServiceHba::QueryHbaPorts (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 IEnumVdsObject que contém uma lista das portas HBA conhecidas pelo VDS no sistema local.

Sintaxe

HRESULT QueryHbaPorts(
  [out] IEnumVdsObject **ppEnum
);

Parâmetros

[out] ppEnum

O endereço de um ponteiro de interface IEnumVdsObject que pode ser usado para enumerar as portas HBA como objetos de porta HBA. Para obter mais informações, consulte Trabalhando com objetos de enumeração. Os chamadores devem liberar a interface e cada um dos objetos de porta HBA 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
S_OK
A enumeração de portas HBA foi retornada com êxito. Se o sistema local não tiver portas HBA, a enumeração estará vazia.
VDS_E_INITIALIZED_FAILED
0x80042401L
Falha ao inicializar o VDS. Se um aplicativo chamar esse método antes que o serviço VDS 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vds.h

Confira também

IEnumVdsObject

IVdsServiceHba