Metodo IVdsIscsiInitiatorAdapter::LogoutFromTarget (vds.h)

Articolo
03/08/2023

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Esegue una disconnessione manuale da una destinazione iSCSI in tutte le sessioni iSCSI alla destinazione specificata.

Sintassi

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

Parametri

[in] targetId

Il VDS_OBJECT_ID della destinazione da cui disconnettersi.

[out] ppAsync

Indirizzo di un puntatore all'interfaccia IVdsAsync . VDS inizializza l'interfaccia in caso di restituzione. I chiamanti devono rilasciare l'interfaccia. Usare questa interfaccia per annullare, attendere o eseguire una query sullo stato dell'operazione. Se viene chiamato IVdsAsync::Wait su questa interfaccia e viene restituito un valore HRESULT riuscito, le interfacce restituite nella struttura VDS_ASYNC_OUTPUT devono essere rilasciate chiamando il metodo IUnknown::Release su ogni puntatore di interfaccia. Tuttavia, se Wait restituisce un valore HRESULT non riuscito o se il parametro pHrResult di Wait riceve un valore HRESULT non riuscito, i puntatori di interfaccia nella struttura VDS_ASYNC_OUTPUT sono NULL e non devono essere rilasciati. È possibile verificare l'esito positivo o negativo dei valori HRESULT usando le macro SUCCEEDED e FAILED definite in Winerror.h.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
S_OK	Il gruppo del portale è stato eliminato correttamente.
VDS_E_ISCSI_LOGOUT_FAILED 0x80042709L	Disconnessione non riuscita.
VDS_E_ISCSI_SESSION_NOT_FOUND 0x8004270AL	Il VDS non è riuscito a trovare una sessione corrispondente alla destinazione specificata.
VDS_E_ISCSI_LOGOUT_INCOMPLETE 0x80042710L	Almeno una sessione non è stata disconnessa correttamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib
Componente ridistribuibile	VDS 1.1

Vedi anche

IVdsAsync

IVdsIscsiInitiatorAdapter

Condividi tramite