Método IVdsServiceIscsi::RememberTargetSharedSecret (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.]

Comunica el secreto compartido chap de un destino al servicio iniciador. Este secreto compartido se usa durante el inicio de sesión de destino cuando el destino autentica al iniciador.

Sintaxis

HRESULT RememberTargetSharedSecret(
  [in] VDS_OBJECT_ID           targetId,
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret
);

Parámetros

[in] targetId

El VDS_OBJECT_ID del destino que tiene el secreto compartido especificado. Este parámetro es necesario y no se puede GUID_NULL.

[in] pTargetSharedSecret

Dirección de una estructura de VDS_ISCSI_SHARED_SECRET que contiene el secreto compartido de CHAP.

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
S_OK	El secreto compartido se recordó correctamente.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS no se pudo inicializar. Si una aplicación llama a este método antes de que el servicio termine de inicializarse, el método se bloqueará hasta que se complete la inicialización. Si se produce un error en la inicialización, se devuelve este error.

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

Consulte también

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi

IVdsServiceIscsi::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET