IVdsServiceIscsi::RememberTargetSharedSecret-Methode (vds.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Kommuniziert das freigegebene CHAP-Geheimnis eines Ziels an den Initiatordienst. Dieses freigegebene Geheimnis wird während der Zielanmeldung verwendet, wenn das Ziel den Initiator authentifiziert.

Syntax

HRESULT RememberTargetSharedSecret(
  [in] VDS_OBJECT_ID           targetId,
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret
);

Parameter

[in] targetId

Die VDS_OBJECT_ID des Ziels, das über das angegebene freigegebene Geheimnis verfügt. Dieser Parameter ist erforderlich und kann nicht GUID_NULL werden.

[in] pTargetSharedSecret

Die Adresse einer VDS_ISCSI_SHARED_SECRET-Struktur , die das freigegebene CHAP-Geheimnis enthält.

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 HRESULT_FROM_WIN32-Makros 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 gespeichert.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben.

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::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET