SERVER_TRANSPORT_INFO_3-Struktur (lmserver.h)
Die SERVER_TRANSPORT_INFO_3-Struktur enthält Informationen zum angegebenen Transportprotokoll, einschließlich Name, Adresse und Kennwort (Anmeldeinformationen). Diese Informationsebene ist nur für die NetServerTransportAddEx-Funktion gültig.
Syntax
typedef struct _SERVER_TRANSPORT_INFO_3 {
DWORD svti3_numberofvcs;
LMSTR svti3_transportname;
LPBYTE svti3_transportaddress;
DWORD svti3_transportaddresslength;
LMSTR svti3_networkaddress;
LMSTR svti3_domain;
ULONG svti3_flags;
DWORD svti3_passwordlength;
BYTE svti3_password[256];
} SERVER_TRANSPORT_INFO_3, *PSERVER_TRANSPORT_INFO_3, *LPSERVER_TRANSPORT_INFO_3;
Members
svti3_numberofvcs
Art: DWORD
Die Anzahl der Clients, die mit dem Server verbunden sind, die das vom svti3_transportname-Member angegebene Transportprotokoll verwenden.
svti3_transportname
Typ: LMSTR
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen eines Transportgeräts enthält; Zum Beispiel
\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}
Diese Zeichenfolge ist Unicode, wenn _WIN32_WINNT oder FORCE_UNICODE definiert sind.
svti3_transportaddress
Typ: LPBYTE
Ein Zeiger auf eine Variable, die die Adresse enthält, die der Server auf dem Transportgerät verwendet, das vom svti3_transportname-Member angegeben wird.
Dieser Member ist in der Regel der NetBIOS-Name, den der Server verwendet. In diesen Fällen muss der Name 16 Zeichen lang sein, und das letzte Zeichen muss ein leeres Zeichen (0x20) sein.
svti3_transportaddresslength
Art: DWORD
Die Länge des svti3_transportaddress-Elements in Bytes. Für NetBIOS-Namen ist der Wert dieses Members 16 (dezimal).
svti3_networkaddress
Typ: LMSTR
Ein Zeiger auf eine NULL-endende Zeichenfolge, die die Adresse enthält, die der Netzwerkadapter verwendet. Die Zeichenfolge ist transportspezifisch.
Sie können diesen Wert nur mit einem Aufruf der NetServerTransportEnum-Funktion abrufen. Sie können diesen Wert nicht mit einem Aufruf der NetServerTransportAdd-Funktion oder der NetServerTransportAddEx-Funktion festlegen.)
Diese Zeichenfolge ist Unicode, wenn _WIN32_WINNT oder FORCE_UNICODE definiert sind.
svti3_domain
Typ: LMSTR
Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen der Domäne enthält, an die der Server seine Anwesenheit ankündigen soll. (Wenn Sie NetServerTransportEnum aufrufen, ist dieser Member der Name der Domäne, für die der Server seine Anwesenheit ankündigt.)
Diese Zeichenfolge ist Unicode, wenn _WIN32_WINNT oder FORCE_UNICODE definiert sind.
svti3_flags
Typ: ULONG
Dieser Member kann eine Kombination der folgenden Bitwerte sein, die in der Lmserver.h-Headerdatei definiert sind.
svti3_passwordlength
Art: DWORD
Die Anzahl der gültigen Bytes im svti3_password-Member .
svti3_password[256]
Typ: BYTE[256]
Die Anmeldeinformationen, die für die neue Transportadresse verwendet werden sollen. Wenn der svti3_passwordlength Member null ist, werden die Anmeldeinformationen für den Server verwendet.
Hinweise
Die SERVER_TRANSPORT_INFO_3-Struktur wird von der NetServerTransportAddEx-Funktion verwendet, um den angegebenen Server an das Transportprotokoll zu binden.
Es folgt ein Beispiel für die Verwendung des SVTI2_REMAP_PIPE_NAMES Werts. Rufen Sie die NetServerTransportAddEx-Funktion auf, um dem Server einen Transport hinzuzufügen. Geben Sie dabei die Adresse von "MyServer" im svti3_transportaddress-Member und SVTI2_REMAP_PIPE_NAMES im svti3_flags-Member an. Wenn ein Client versucht, "Pipe" auf "\MyServer" zu öffnen, wird der Client stattdessen $$MyServer\Pipe geöffnet.
Die svti3_passwordlength - und svti3_password-Member sind erforderlich, damit ein Client und ein Server eine gegenseitige Authentifizierung durchführen können.
Unter Windows Server 2008 und Windows Vista mit SP1 wird jeder Name, der beim Windows-Remotedateiserver (SRV) registriert ist, entweder als Bereichsname oder als nicht bereichsbezogener Name festgelegt. Jede Freigabe, die dem System hinzugefügt wird, wird dann entweder an alle nicht bereichsbezogenen Namen oder an einen einzelnen Bereichsnamen angefügt. Anwendungen, die die Bereichsfeatures verwenden möchten, sind sowohl für die Registrierung des neuen Namens als bereichsbezogenen Endpunkt als auch für das Erstellen der Freigaben mit einem geeigneten Bereich verantwortlich. Auf diese Weise sind ältere Verwendungen der Funktionen Netzwerkverwaltung und Netzwerkfreigabeverwaltung in keiner Weise betroffen, da sie weiterhin Freigaben und Namen als nicht bereichsbezogene Namen registrieren.
Ein bereichsbezogener Endpunkt wird erstellt, indem die NetServerTransportAddEx-Funktion aufgerufen wird, wobei der level-Parameter auf 2 festgelegt ist und der bufptr-Parameter auf eine SERVER_TRANSPORT_INFO_2-Struktur zeigt, deren SVTI2_SCOPED_NAME Bitwert in svti2_flags Member festgelegt ist. Ein bereichsbezogener Endpunkt wird auch durch Aufrufen der NetServerTransportAddEx-Funktion mit dem level-Parameter auf 3 und dem bufptr-Parameter auf eine SERVER_TRANSPORT_INFO_3-Struktur mit dem SVTI2_SCOPED_NAME Bitwert in svti3_flags Member festgelegt.
Wenn der SVTI2_SCOPED_NAME Bitwert für einen Transport festgelegt ist, können Freigaben mit einem entsprechenden Servernamen (dem shi503_servername Member der SHARE_INFO_503-Struktur ) bereichsgesteuert mithilfe der NetShareAdd-Funktion hinzugefügt werden. Wenn kein Transport mit dem SVTI2_SCOPED_NAME Bitwert und dem in shi503_servername Member bereitgestellten Namen registriert ist, ist die freigabebezogene Add nicht erfolgreich.
Die NetShareAdd-Funktion wird verwendet, um eine bereichsbezogene Freigabe auf einem Remoteserver hinzuzufügen, der im Servername-Parameter angegeben ist. Der Remoteserver, der im shi503_servername Member der im bufptr-Parameter übergebenen SHARE_INFO_503 angegeben ist, muss mit der NetServerTransportAddEx-Funktion als bereichsbezogenem Endpunkt an ein Transportprotokoll gebunden worden sein. Das SVTI2_SCOPED_NAME-Flag muss im shi503_servername-Member der SERVER_TRANSPORT_INFO_2 - oder SERVER_TRANSPORT_INFO_3-Struktur für das Transportprotokoll angegeben worden sein. Die NetShareDelEx-Funktion wird verwendet, um eine bereichsbezogene Freigabe zu löschen. Die Funktionen NetShareGetInfo und NetShareSetInfo dienen zum Abrufen und Festlegen von Informationen für eine bereichsbezogene Freigabe.
Bereichsbezogene Endpunkte werden im Allgemeinen vom Clusternamespace verwendet.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | lmserver.h (lm.h einschließen) |