AddConnectionToSession_IN-Struktur (iscsiop.h)
Die AddConnectionToSession_IN-Struktur enthält Eingabedaten für die AddConnectionToSession-Methode , die verwendet wird, um einer bereits vorhandenen Sitzung eine neue Verbindung hinzuzufügen.
Syntax
typedef struct _AddConnectionToSession_IN {
ULONGLONG UniqueAdapterId;
ULONGLONG UniqueSessionId;
ULONGLONG SecurityFlags;
ULONG PortNumber;
ISCSI_LoginOptions LoginOptions;
ISCSI_TargetPortal TargetPortal;
ULONG UsernameSize;
ULONG PasswordSize;
ULONG KeySize;
UCHAR Key[1];
} AddConnectionToSession_IN, *PAddConnectionToSession_IN;
Member
UniqueAdapterId
Eine 64-Bit-Ganzzahl, die einen Adapter und eine bestimmte geladene instance eines Speicherminiporttreibers, der den Adapter verwaltet, eindeutig identifiziert. Dieser Bezeichner ist nicht nur auf dem Computer, auf dem sich der Adapter befindet, sondern auch im gesamten Netzwerk eindeutig.
UniqueSessionId
Eine 64-Bit-Ganzzahl, die die Sitzung eindeutig identifiziert. Die Methoden LoginToTarget und AddConnectionToSession geben diesen Wert im UniqueSessionId-Parameter zurück. Verwechseln Sie diesen Wert nicht mit den Werten in den ELEMENTEN ISID und TSID.
SecurityFlags
Ein bitweises OR von Flags, die die Sicherheitsanforderungen eines Ziels angeben. Eine Liste der möglichen Werte für dieses Element finden Sie unter SECURITY_FLAG_QUALIFIERS.
PortNumber
Die Nummer des Ports, von dem aus die Zielanmeldungssitzung initiiert werden soll.
LoginOptions
Eine ISCSI_LoginOptions Struktur, die die Merkmale der Zielanmeldungssitzung beschreibt, der eine Verbindung hinzugefügt wird.
TargetPortal
Eine ISCSI_TargetPortal Struktur, die angibt, welches Zielportal zum Herstellen der zusätzlichen Verbindung verwendet werden soll. Die AddConnectionToSession-Methode ruft die LoginToTarget-Methode auf, um die neue Verbindung herzustellen. Wenn LoginToTarget mit einem status Wert entweder ISCSC_TARGET_MOVED_PERMANENTLY oder ISCSC_TARGET_MOVED_TEMPORARILY fehlschlägt. TargetPortal gibt in der Ausgabe von AddConnectionToSession das Portal an, an das der Anmeldevorgang umgeleitet werden soll. Weitere Informationen zu den werten ISCSC_TARGET_MOVED_PERMANENTLY und ISCSC_TARGET_MOVED_TEMPORARILY status finden Sie unter ISCSI_STATUS_QUALIFIERS.
UsernameSize
Die Größe des Benutzernamens in Bytes.
PasswordSize
Die Kennwortgröße in Bytes.
KeySize
Die vorab freigegebene Schlüsselgröße in Bytes.
Key[1]
Ein Array mit Zeichen variabler Länge, das den vorab freigegebenen Schlüssel angibt, der der Ziel-IP-Adresse zugeordnet ist. Die Anzahl der Elemente im Array wird durch das Feld KeySize angegeben.
Hinweise
Für den iSCSI-Dienst ist diese Methode erforderlich. Es ist optional, dass Sie diese Methode implementieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | iscsiop.h (include Iscsiop.h) |