Método IVdsIscsiInitiatorAdapter::LoginToTarget (vds.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows].]

Realiza un inicio de sesión manual en un destino iSCSI.

Syntax

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
);

Parámetros

[in] loginType

Tipo de inicio de sesión que se realizará, enumerado por VDS_ISCSI_LOGIN_TYPE.

[in] targetId

El VDS_OBJECT_ID del destino al que se va a iniciar sesión. GUID_NULL indica que el iniciador es seleccionar el portal.

[in] targetPortalId

El VDS_OBJECT_ID del portal de destino mediante el cual se realiza la operación de inicio de sesión. GUID_NULL indica que el iniciador es seleccionar el portal.

[in] initiatorPortalId

El VDS_OBJECT_ID del portal del iniciador mediante el cual se realiza la operación de inicio de sesión.

[in] ulLoginFlags

Marcas enumeradas por VDS_ISCSI_LOGIN_FLAG especificar opciones de inicio de sesión.

[in] bHeaderDigest

Si es TRUE, el iniciador debe habilitar el resumen de encabezado al iniciar sesión en el portal de destino.

[in] bDataDigest

Si es TRUE, el iniciador debe habilitar el resumen de datos al iniciar sesión en el portal de destino.

[in] authType

Tipo de autenticación necesario para iniciar sesión en el destino, enumerado por VDS_ISCSI_AUTH_TYPE.

[out] ppAsync

Dirección de un puntero de interfaz IVdsAsync . VDS inicializa la interfaz a cambio. Los autores de llamadas deben liberar la interfaz. Use esta interfaz para cancelar, esperar o consultar el estado de la operación. Si se llama a IVdsAsync::Wait en esta interfaz y se devuelve un valor HRESULT correcto, las interfaces devueltas en la estructura de VDS_ASYNC_OUTPUT deben liberarse llamando al método IUnknown::Release en cada puntero de interfaz. Sin embargo, si Wait devuelve un valor HRESULT de error o si el parámetro pHrResult de Wait recibe un valor HRESULT de error, los punteros de interfaz de la estructura VDS_ASYNC_OUTPUT son NULL y no es necesario liberarlos. Puede probar los valores HRESULT correctos o erróneos mediante las macros SUCCEEDED y FAILED definidas en Winerror.h.

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Requisitos

Consulte también

IVdsAsync

IVdsIscsiInitiatorAdapter

VDS_ISCSI_AUTH_TYPE

VDS_ISCSI_LOGIN_FLAG

VDS_ISCSI_LOGIN_TYPE