Freigeben über


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.

Wert Bedeutung
SVTI2_REMAP_PIPE_NAMES
Wenn dieser Wert für einen Endpunkt festgelegt ist, werden Clientanforderungen, die über den Transport eingehen, um eine Named 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 in Konflikt stehenden 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.

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)

Weitere Informationen

NetServerTransportAdd

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

NetShareAdd

NetShareDelEx

NetShareGetInfo

NetShareSetInfo

Übersicht über die Netzwerkverwaltung

Netzwerkverwaltungsstrukturen

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SHARE_INFO_503

Server- und Arbeitsstationstransportfunktionen