Compartilhar via


Método IVdsIscsiInitiatorAdapter::LogoutFromTarget (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.]

Executa um logoff manual de um destino iSCSI em todas as sessões iSCSI para o destino especificado.

Sintaxe

HRESULT LogoutFromTarget(
  [in]  VDS_OBJECT_ID targetId,
  [out] IVdsAsync     **ppAsync
);

Parâmetros

[in] targetId

O VDS_OBJECT_ID do destino do qual fazer logoff.

[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 nessa interface e um valor HRESULT bem-sucedido 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 da 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.

Valor de retorno

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
O grupo de portal foi excluído com êxito.
VDS_E_ISCSI_LOGOUT_FAILED
0x80042709L
Falha na logoff.
VDS_E_ISCSI_SESSION_NOT_FOUND
0x8004270AL
O VDS não pôde encontrar uma sessão que corresponda ao destino especificado.
VDS_E_ISCSI_LOGOUT_INCOMPLETE
0x80042710L
Pelo menos uma sessão não fez logoff com êxito.

Requirements

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

Consulte também

IVdsAsync

IVdsIscsiInitiatorAdapter