SERVER_TRANSPORT_INFO_2-Struktur (lmserver.h)

Artikel
08/24/2023

Die SERVER_TRANSPORT_INFO_2-Struktur enthält Informationen zum angegebenen Transportprotokoll, einschließlich Transportname und Adresse. Diese Informationsebene ist nur für die NetServerTransportAddEx-Funktion gültig.

Syntax

typedef struct _SERVER_TRANSPORT_INFO_2 {
  DWORD  svti2_numberofvcs;
  LMSTR  svti2_transportname;
  LPBYTE svti2_transportaddress;
  DWORD  svti2_transportaddresslength;
  LMSTR  svti2_networkaddress;
  LMSTR  svti2_domain;
  ULONG  svti2_flags;
} SERVER_TRANSPORT_INFO_2, *PSERVER_TRANSPORT_INFO_2, *LPSERVER_TRANSPORT_INFO_2;

Members

svti2_numberofvcs

Art: DWORD

Die Anzahl der Clients, die mit dem Server verbunden sind, die das vom svti2_transportname-Member angegebene Transportprotokoll verwenden.

svti2_transportname

Typ: LMSTR

Ein Zeiger auf eine NULL-beendete 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.

svti2_transportaddress

Typ: LPBYTE

Ein Zeiger auf eine Variable, die die Adresse enthält, die der Server auf dem vom svti2_transportname-Member angegebenen Transportgerät verwendet.

Dieser Member ist normalerweise 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.

svti2_transportaddresslength

Art: DWORD

Die Länge des svti2_transportaddress-Members in Bytes. Für NetBIOS-Namen ist der Wert dieses Members 16 (dezimal).

svti2_networkaddress

Typ: LMSTR

Ein Zeiger auf eine NULL-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.

svti2_domain

Typ: LMSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen der Domäne enthält, für 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.

svti2_flags

Typ: ULONG

Dieses Element kann eine Kombination der folgenden Bitwerte sein, die in der Headerdatei Lmserver.h definiert sind.

Wert	Bedeutung
SVTI2_REMAP_PIPE_NAMES	Wenn dieser Wert für einen Endpunkt festgelegt ist, werden Clientanforderungen, die über den Transport eingehen, um eine benannte Pipe zu öffnen, an den folgenden lokalen Pipenamen umgeleitet (neu zugeordnet): $$\ServerName\PipeName Weitere Informationen zur Verwendung dieses Werts finden Sie im Abschnitt Hinweise.
SVTI2_SCOPED_NAME	Wenn dieser Wert für einen Endpunkt festgelegt ist und versucht wird, einen zweiten Transport mit derselben Netzwerkadresse, aber einem anderen Transportnamen und konfliktierenden Einstellungen für das SCOPED-Flag zu erstellen, schlägt diese Transporterstellung fehl. Daher muss jeder registrierte Transport für eine bestimmte Netzwerkadresse die gleiche bereichsbezogene Einstellung aufweisen. Weitere Informationen zur Verwendung dieses Werts finden Sie im Abschnitt Hinweise. Dieser Wert wird unter Windows Server 2008 und Windows Vista mit SP1 definiert.

Wert

Bedeutung

SVTI2_REMAP_PIPE_NAMES

Wenn dieser Wert für einen Endpunkt festgelegt ist, werden Clientanforderungen, die über den Transport eingehen, um eine benannte Pipe zu öffnen, an den folgenden lokalen Pipenamen umgeleitet (neu zugeordnet):

$$\ServerName\PipeName

Weitere Informationen zur Verwendung dieses Werts finden Sie im Abschnitt Hinweise.

SVTI2_SCOPED_NAME

Wenn dieser Wert für einen Endpunkt festgelegt ist und versucht wird, einen zweiten Transport mit derselben Netzwerkadresse, aber einem anderen Transportnamen und konfliktierenden Einstellungen für das SCOPED-Flag zu erstellen, schlägt diese Transporterstellung fehl. Daher muss jeder registrierte Transport für eine bestimmte Netzwerkadresse die gleiche bereichsbezogene Einstellung aufweisen.

Weitere Informationen zur Verwendung dieses Werts finden Sie im Abschnitt Hinweise.

Dieser Wert wird unter Windows Server 2008 und Windows Vista mit SP1 definiert.

Hinweise

Die SERVER_TRANSPORT_INFO_2-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 werts SVTI2_REMAP_PIPE_NAMES. Rufen Sie die NetServerTransportAddEx-Funktion auf, um dem Server einen Transport hinzuzufügen, indem Sie die Adresse von "MyServer" im svti2_transportaddress-Member angeben und imsvti2_flags-Member SVTI2_REMAP_PIPE_NAMES. Wenn ein Client versucht, "Pipe" auf "\MyServer" zu öffnen, öffnet der Client stattdessen $$MyServer\Pipe.

Unter Windows Server 2008 und Windows Vista mit SP1 wird jeder name, der beim Windows-Remotedateiserver (SRV) registriert ist, entweder als bereichsbezogener Name oder als nicht bereichsbezogener Name angegeben. Jede Freigabe, die dem System hinzugefügt wird, wird dann entweder an alle Nicht-Bereichsnamen 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 die Erstellung der Freigaben mit einem entsprechenden Bereich verantwortlich. Auf diese Weise sind legacy-Verwendungen der Funktionen Netzwerkverwaltung und Netzwerkfreigabeverwaltung in keiner Weise betroffen, da freigaben und Namen weiterhin als nicht bereichsbezogene Namen registriert werden.

Ein bereichsbezogener Endpunkt wird erstellt, indem die NetServerTransportAddEx-Funktion aufgerufen wird, wobei der Levelparameter auf 2 festgelegt ist und der bufptr-Parameter auf eine SERVER_TRANSPORT_INFO_2-Struktur verweist, wobei der SVTI2_SCOPED_NAME Bitwert in svti2_flags Member festgelegt ist. Ein bereichsbezogener Endpunkt wird auch erstellt, indem die NetServerTransportAddEx-Funktion aufgerufen wird, wobei der Levelparameter auf 3 festgelegt ist und der bufptr-Parameter auf eine SERVER_TRANSPORT_INFO_3-Struktur verweist, wobei der SVTI2_SCOPED_NAME Bitwert in svti3_flags Member festgelegt ist.

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 ) auf bereichsbezogene Weise mithilfe der NetShareAdd-Funktion hinzugefügt werden. Wenn kein Transport mit dem SVTI2_SCOPED_NAME Bitwert und dem in shi503_servername Member angegebenen 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 remote Server, der im shi503_servername Member des SHARE_INFO_503 angegeben ist, der im bufptr-Parameter übergeben wurde, muss an ein Transportprotokoll gebunden worden sein, wobei die NetServerTransportAddEx-Funktion als bereichsbezogener Endpunkt verwendet wurde. 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 zu einer bereichsbezogenen Freigabe.

Bereichsbezogene Endpunkte werden in der Regel 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)