Metodo IVdsIscsiInitiatorAdapter::LoginToTarget (vds.h)

[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 un accesso manuale a una destinazione iSCSI.

Sintassi

HRESULT LoginToTarget(
  [in]  VDS_ISCSI_LOGIN_TYPE loginType,
  [in]  VDS_OBJECT_ID        targetId,
  [in]  VDS_OBJECT_ID        targetPortalId,
  [in]  VDS_OBJECT_ID        initiatorPortalId,
  [in]  ULONG                ulLoginFlags,
  [in]  BOOL                 bHeaderDigest,
  [in]  BOOL                 bDataDigest,
  [in]  VDS_ISCSI_AUTH_TYPE  authType,
  [out] IVdsAsync            **ppAsync
);

Parametri

[in] loginType

Tipo di account di accesso che verrà eseguito, enumerato da VDS_ISCSI_LOGIN_TYPE.

[in] targetId

Il VDS_OBJECT_ID della destinazione a cui accedere. GUID_NULL indica che l'iniziatore deve selezionare il portale.

[in] targetPortalId

Il VDS_OBJECT_ID del portale di destinazione in base al quale viene eseguita l'operazione di accesso. GUID_NULL indica che l'iniziatore deve selezionare il portale.

[in] initiatorPortalId

Il VDS_OBJECT_ID del portale iniziatore mediante il quale viene eseguita l'operazione di accesso.

[in] ulLoginFlags

Flag enumerati da VDS_ISCSI_LOGIN_FLAG specificare le opzioni di accesso.

[in] bHeaderDigest

Se TRUE, l'iniziatore deve abilitare il digest dell'intestazione durante l'accesso al portale di destinazione.

[in] bDataDigest

Se TRUE, l'iniziatore deve abilitare il digest dei dati durante l'accesso al portale di destinazione.

[in] authType

Tipo di autenticazione necessario per accedere alla destinazione, enumerata da VDS_ISCSI_AUTH_TYPE.

[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 disco rigido virtuale stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Requisiti

Vedere anche

IVdsAsync

IVdsIscsiInitiatorAdapter

VDS_ISCSI_AUTH_TYPE

VDS_ISCSI_LOGIN_FLAG

VDS_ISCSI_LOGIN_TYPE