Método IVdsControllerControllerPort::QueryControllerPorts (vds.h)

[A partir do Windows 8 e do 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 IEnumVdsObject que enumera as portas do controlador.

Sintaxe

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

[out] ppEnum

O endereço de um ponteiro de interface IEnumVdsObject que pode ser usado para enumerar as portas do controlador como objetos de porta do controlador. Para obter mais informações, consulte Como trabalhar com objetos de enumeração. Os chamadores devem liberar a interface e cada um dos objetos de porta do controlador quando eles não forem mais necessários chamando o método IUnknown::Release .

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 valores retornados possíveis incluem o seguinte.

Código/valor de retorno	Description
S_OK	A enumeração das portas do controlador foi retornada com êxito. Se o controlador não tiver portas, a enumeração estará vazia.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	O cache do provedor está corrompido. Isso indica um problema de software ou comunicação dentro de um provedor que armazena em cache informações sobre os dispositivos anexados. O chamador pode usar o método IVdsHwProvider::Reenumerate seguido pelo método IVdsHwProvider::Refresh para restaurar o cache.
VDS_E_OBJECT_DELETED 0x8004240BL	O objeto do controlador não está mais presente.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	O controlador está em um estado com falha e não consegue executar a operação solicitada.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Outra operação está em andamento. Essa operação não pode continuar até que as operações anteriores sejam concluídas.
VDS_E_NOT_SUPPORTED 0x80042400L	Essa operação não é compatível com esse provedor.

Requirement	Value
Cliente mínimo suportado	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows Server 2003 R2 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
Header	vds.h

Esta página foi útil?