Método IVdsServiceIscsi::SetInitiatorSharedSecret (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.]
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 |
|---|---|
|
El secreto compartido se estableció correctamente. |
|
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. |
|
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 |
Vea también
IVdsIscsiTarget::RememberInitiatorSharedSecret
IVdsIscsiTarget::SetSharedSecret