Método IVdsServiceIscsi::SetInitiatorSharedSecret (vds.h)

Artículo
03/08/2023

[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.]

Establece el secreto compartido chap del iniciador que se usa para la autenticación CHAP mutua cuando el iniciador autentica el destino.

Sintaxis

HRESULT SetInitiatorSharedSecret(
  [in] VDS_ISCSI_SHARED_SECRET *pInitiatorSharedSecret,
  [in] VDS_OBJECT_ID           targetId
);

Parámetros

[in] pInitiatorSharedSecret

Dirección de una estructura de VDS_ISCSI_SHARED_SECRET que contiene el secreto compartido. Si el miembro pSharedSecret es NULL y ulSharedSecretSize es cero, el método SetInitiatorSharedSecret borra cualquier secreto existente. Si este parámetro es NULL y el parámetro targetId no está GUID_NULL, SetInitiatorSharedSecret borra la asociación entre el iniciador y el destino.

[in] targetId

El VDS_OBJECT_ID del destino. Este parámetro se establece en GUID_NULL si el secreto compartido no es específico del destino.

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.

Código o valor devuelto	Descripción
S_OK	El secreto compartido se estableció 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.
VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED 0x80042706L	El servicio iniciador no admite la configuración de secretos compartidos específicos del destino.

Comentarios

Un iniciador puede admitir la configuración de un secreto compartido chap diferente para cada destino.

No hay ninguna manera de determinar mediante programación si un iniciador admite secretos específicos del destino. Si la llamada a SetInitiatorSharedSecret devuelve VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED, vuelva a llamar al método y establezca el parámetro targetId en GUID_NULL.

El iniciador de software iSCSI de Microsoft no admite la configuración de secretos específicos del destino.

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