Metodo IVdsIscsiTarget::SetSharedSecret (vdshwprv.h)

Articolo
03/08/2023

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Imposta il segreto condiviso CHAP di destinazione usato per l'autenticazione CHAP quando la destinazione autentica l'iniziatore.

Sintassi

HRESULT SetSharedSecret(
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret,
  [in] LPWSTR                  pwszInitiatorName
);

Parametri

[in] pTargetSharedSecret

Indirizzo di una struttura VDS_ISCSI_SHARED_SECRET contenente il segreto condiviso. Se il membro pSharedSecret è NULL e ulSharedSecretSize è zero, il metodo SetSharedSecret cancella qualsiasi segreto esistente.

[in] pwszInitiatorName

Stringa che specifica il nome iSCSI a cui deve essere associato il segreto condiviso, se il segreto è initiator-specific. Il valore passato viene usato come nome CHAP. Se l'indirizzo è NULL , le modifiche si applicano al segreto predefinito per tutti gli iniziatori.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
S_OK	Il segreto condiviso è stato impostato correttamente.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	La cache del provider è danneggiata. Ciò indica un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sui dispositivi collegati. Il chiamante può usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider ::Refresh per ripristinare la cache.
VDS_E_OBJECT_DELETED 0x8004240BL	L'oggetto di destinazione non è più presente.
VDS_E_NOT_SUPPORTED 0x80042400L	Questa operazione o combinazione di parametri non è supportata da questo provider.
VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED 0x80042707L	La destinazione non supporta segreti condivisi specifici dell'iniziatore.

Commenti

Il provider hardware deve configurare il sottosistema stesso per modificare il segreto condiviso di destinazione. I segreti usati per la sicurezza non sono persistenti da VDS né devono essere mantenuti dai provider hardware nel computer locale. Il provider hardware deve trasmettere il segreto al sottosistema in modo sicuro e il sottosistema è responsabile della sua persistente insistenza.

Alcune destinazioni iSCSI possono supportare l'impostazione di un segreto condiviso CHAP diverso per ogni iniziatore. Se una destinazione non supporta segreti specifici dell'iniziatore, la chiamata a SetSharedSecret restituisce VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vdshwprv.h
Libreria	Uuid.lib
Componente ridistribuibile	VDS 1.1

Vedi anche

IVdsIscsiTarget

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET

Condividi tramite