Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]
Legt den freigegebenen CHAP-Zielschlüssel fest, der für die CHAP-Authentifizierung verwendet wird, wenn das Ziel den Initiator authentifiziert.
Syntax
HRESULT SetSharedSecret(
[in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret,
[in] LPWSTR pwszInitiatorName
);
Die Parameter
[in] pTargetSharedSecret
Die Adresse einer VDS_ISCSI_SHARED_SECRET Struktur, die den freigegebenen geheimen Schlüssel enthält. Wenn das pSharedSecret-ElementNULL ist und die ulSharedSecretSize null ist, löscht die SetSharedSecret-Methode alle vorhandenen geheimen Schlüssel.
[in] pwszInitiatorName
Die Zeichenfolge, die den iSCSI-Namen angibt, dem der freigegebene Geheimschlüssel zugeordnet werden soll, wenn der geheime Schlüssel initiatorspezifisch ist. Der übergebene Wert wird als CHAP-Name verwendet. Wenn die Adresse NULL ist, gelten die Änderungen für den Standardschlüssel für alle Initiatoren.
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Sie kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32 Makros zurückgeben. Fehler können von VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Mögliche Rückgabewerte sind:
| Zurückgeben von Code/Wert | Description |
|---|---|
|
Der freigegebene geheime Schlüssel wurde erfolgreich festgelegt. |
|
Der Cache des Anbieters ist beschädigt. Dies weist auf ein Software- oder Kommunikationsproblem innerhalb eines Anbieters hin, der Informationen über die angeschlossenen Geräte zwischenspeichert. Der Aufrufer kann die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode verwenden, um den Cache wiederherzustellen. |
|
Das Zielobjekt ist nicht mehr vorhanden. |
|
Dieser Vorgang oder eine Kombination von Parametern wird von diesem Anbieter nicht unterstützt. |
|
Das Ziel unterstützt keine initiatorspezifischen freigegebenen Geheimschlüssel. |
Bemerkungen
Der Hardwareanbieter muss das Subsystem selbst konfigurieren, um den freigegebenen Zielschlüssel zu ändern. Geheime Schlüssel, die für die Sicherheit verwendet werden, werden nicht von VDS beibehalten, oder sie sollten von den Hardwareanbietern auf dem lokalen Computer beibehalten werden. Der Hardwareanbieter sollte den geheimen Schlüssel auf sichere Weise an das Subsystem übertragen, und das Subsystem ist dafür verantwortlich, es beizubehalten.
Einige iSCSI-Ziele unterstützen möglicherweise das Festlegen eines anderen freigegebenen CHAP-Schlüssels für jeden Initiator. Wenn ein Ziel initiatorspezifische geheime Schlüssel nicht unterstützt, gibt der Aufruf von SetSharedSecret VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows Vista [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform | Fenster |
| Header | vdshwprv.h |
| Library | Uuid.lib |
| Weiterverteilbar | VDS 1.1 |
Siehe auch
IVdsIscsiTarget::RememberInitiatorSharedSecret
IVdsIscsiTarget::SetSharedSecret