Método IVdsIscsiPortalGroup::D elete (vdshwprv.h)

Artigo
03/08/2023

[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.]

Exclui o grupo do portal.

Sintaxe

HRESULT Delete(
  [out] IVdsAsync **ppAsync
);

Parâmetros

[out] ppAsync

O endereço de um ponteiro de interface IVdsAsync . O VDS inicializa a interface no retorno. Os chamadores devem liberar a interface . Use essa interface para cancelar, aguardar ou consultar o status da operação. Se IVdsAsync::Wait for chamado e um valor HRESULT de êxito for retornado, as interfaces retornadas na estrutura VDS_ASYNC_OUTPUT deverão ser liberadas chamando o método IUnknown::Release em cada ponteiro de interface. No entanto, se Wait retornar um valor HRESULT de falha ou se o parâmetro pHrResult de Wait receber um valor HRESULT de falha, os ponteiros de interface na estrutura VDS_ASYNC_OUTPUT serão NULL e não precisarão ser liberados. Você pode testar valores HRESULT com êxito ou falha usando as macros SUCCEEDED e FAILED definidas em Winerror.h.

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 ser originados 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	O grupo do portal foi excluído com êxito.
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 portal não está mais presente.
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_ASSOCIATED_PORTALS_EXIST 0x8004270CL	Os portais estão associados a esse grupo de portal. Todos os portais devem ser desassociados desse grupo de portal antes que esse grupo de portal possa ser excluído.

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	vdshwprv.h
Biblioteca	Uuid.lib
Redistribuível	VDS 1.1

Confira também

IVdsAsync

IVdsIscsiPortalGroup

Compartilhar via