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.
Sintaxis
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 va a 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 que 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 especificando 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 necesaria 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 liberar. 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 se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
El inicio de sesión se completó correctamente. |
|
Otra operación está en curso. Esta operación no puede continuar hasta que se completen las operaciones anteriores. |
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vds.h |
| Library | Uuid.lib |
| Redistribuible | VDS 1.1 |