SERVER_TRANSPORT_INFO_2-Struktur (lmserver.h)
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.
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) |