IVdsServiceIscsi::SetInitiatorSharedSecret-Methode (vds.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]

Legt das freigegebene CHAP-Geheimnis des Initiators fest, das für die gegenseitige CHAP-Authentifizierung verwendet wird, wenn der Initiator das Ziel authentifiziert.

Syntax

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

Parameter

[in] pInitiatorSharedSecret

Die Adresse einer VDS_ISCSI_SHARED_SECRET Struktur, die das freigegebene Geheimnis enthält. Wenn das pSharedSecret-ElementNULL und ulSharedSecretSize null ist, löscht die SetInitiatorSharedSecret-Methode alle vorhandenen Geheimnisse. Wenn dieser Parameter NULL ist und der TargetId-Parameter nicht GUID_NULL ist, löscht SetInitiatorSharedSecret die Zuordnung zwischen dem Initiator und dem Ziel.

[in] targetId

Die VDS_OBJECT_ID des Ziels. Dieser Parameter ist auf GUID_NULL festgelegt, wenn das freigegebene Geheimnis nicht zielspezifisch sein soll.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode/-wert BESCHREIBUNG
S_OK
 Das freigegebene Geheimnis wurde erfolgreich festgelegt.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor die Initialisierung des Diensts abgeschlossen ist, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn die Initialisierung fehlschlägt, wird dieser Fehler zurückgegeben.
VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED
0x80042706L
 Der Initiatordienst unterstützt das Festlegen von zielspezifischen freigegebenen Geheimnissen nicht.

Bemerkungen

Ein Initiator unterstützt möglicherweise das Festlegen eines anderen freigegebenen CHAP-Geheimnisses für jedes Ziel.

Es gibt keine Möglichkeit, programmgesteuert zu bestimmen, ob ein Initiator zielspezifische Geheimnisse unterstützt. Wenn der Aufruf von SetInitiatorSharedSecret VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED zurückgibt, rufen Sie die Methode erneut auf, und legen Sie den targetId-Parameter auf GUID_NULL fest.

Der Microsoft iSCSI-Software-Initiator unterstützt das Festlegen von zielspezifischen Geheimnissen nicht.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib
Verteilbare Komponente VDS 1.1

Weitere Informationen

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi

IVdsServiceIscsi::RememberTargetSharedSecret

VDS_ISCSI_SHARED_SECRET