VDS_ISCSI_SHARED_SECRET Struktur (vds.h)

Artikel
03/08/2023

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

Definiert ein freigegebenes CHAP-Geheimnis.

Syntax

typedef struct _VDS_ISCSI_SHARED_SECRET {
  UCHAR *pSharedSecret;
  ULONG ulSharedSecretSize;
} VDS_ISCSI_SHARED_SECRET;

Member

pSharedSecret

Ein Zeiger auf ein Bytearray, das das freigegebene CHAP-Geheimnis enthält. Wenn ein freigegebenes Geheimnis nicht erforderlich ist, sollte dieser Parameter NULL sein.

ulSharedSecretSize

Die Anzahl der Bytes im Array, auf die das pSharedSecret-Element verweist. Wenn der pSharedSecret-MemberNULL ist, muss dieser Parameter null sein. Wenn pSharedSecret nicht NULL ist, muss dieser Parameter größer oder gleich 12 und kleiner als oder gleich 16 sein.

Hinweise

Diese Struktur wird von den folgenden Methoden verwendet:

IVdsServiceIscsi::SetInitiatorSharedSecret legt das freigegebene Geheimnis für einen iSCSI-Initiator fest. Wenn das pSharedSecret-ElementNULL und das ulSharedSecretSize-Element null ist, löscht SetInitiatorSharedSecret alle vorhandenen freigegebenen Geheimnisse.
IVdsIscsiTarget::SetSharedSecret legt das freigegebene Geheimnis für ein iSCSI-Ziel fest. Wenn das pSharedSecret-ElementNULL und das ulSharedSecretSize-Element null ist, löscht SetSharedSecret alle vorhandenen freigegebenen Geheimnisse.
IVdsServiceIscsi::RememberTargetSharedSecret weist den Initiator an, sich das Geheimnis des Ziels zu merken.
IVdsIscsiTarget::RememberInitiatorSharedSecret weist das Ziel an, sich das Geheimnis des Initiators zu merken.

Bei unidirektionalem CHAP wird das Geheimnis auf dem Ziel festgelegt. Der Initiator muss sich das CHAP-Geheimnis des Ziels merken, um eine erfolgreiche Anmeldung durchführen zu können.

Für gegenseitiges CHAP werden Geheimnisse für das Ziel und den Initiator festgelegt. Um eine erfolgreiche Anmeldung durchzuführen, müssen sich das Ziel und der Initiator an die Geheimnisse des jeweils anderen erinnern.

Anforderungen

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

Weitere Informationen

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi::RememberTargetSharedSecret

IVdsServiceIscsi::SetInitiatorSharedSecret