Metodo IVdsServiceIscsi::SetInitiatorSharedSecret (vds.h)
[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 iniziatore usato per l'autenticazione CHAP reciproca quando l'iniziatore autentica la destinazione.
Sintassi
HRESULT SetInitiatorSharedSecret(
[in] VDS_ISCSI_SHARED_SECRET *pInitiatorSharedSecret,
[in] VDS_OBJECT_ID targetId
);
Parametri
[in] pInitiatorSharedSecret
Indirizzo di una struttura VDS_ISCSI_SHARED_SECRET che contiene il segreto condiviso. Se il membro pSharedSecret è NULL e ulSharedSecretSize è zero, il metodo SetInitiatorSharedSecret cancella qualsiasi segreto esistente. Se questo parametro è NULL e il parametro targetId non è GUID_NULL, SetInitiatorSharedSecret cancella l'associazione tra l'iniziatore e la destinazione.
[in] targetId
VDS_OBJECT_ID della destinazione. Questo parametro è impostato su GUID_NULL se il segreto condiviso non deve essere specifico della destinazione.
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 provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.
| Codice/valore restituito | Descrizione |
|---|---|
|
Il segreto condiviso è stato impostato correttamente. |
|
Impossibile inizializzare VDS. Se un'applicazione chiama questo metodo prima che il servizio completi l'inizializzazione, il metodo viene bloccato fino al completamento dell'inizializzazione. Se l'inizializzazione ha esito negativo, viene restituito questo errore. |
|
Il servizio iniziatore non supporta l'impostazione di segreti condivisi specifici della destinazione. |
Commenti
Un iniziatore può supportare l'impostazione di un segreto condiviso CHAP diverso per ogni destinazione.
Non è possibile determinare a livello di codice se un iniziatore supporta segreti specifici della destinazione. Se la chiamata a SetInitiatorSharedSecret restituisce VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED, chiamare di nuovo il metodo impostando il parametro targetId su GUID_NULL.
L'iniziatore software iSCSI Microsoft non supporta l'impostazione di segreti specifici della destinazione.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vds.h |
| Libreria | Uuid.lib |
| Componente ridistribuibile | VDS 1.1 |
Vedi anche
IVdsIscsiTarget::RememberInitiatorSharedSecret
IVdsIscsiTarget::SetSharedSecret