NetServerTransportAdd-Funktion (lmserver.h)

Artikel
02/28/2024

Die NetServerTransportAdd-Funktion bindet den Server an das Transportprotokoll.

Mit der erweiterten Funktion NetServerTransportAddEx kann die aufrufende Anwendung die SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 und SERVER_TRANSPORT_INFO_3 Informationsebenen angeben.

Syntax

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Parameter

[in] servername

Ein Zeiger auf eine Zeichenfolge, die den Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] level

Gibt die Informationsebene der Daten an. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
0	Gibt Informationen zum Transportprotokoll an, einschließlich Name, Adresse und Speicherort im Netzwerk. Der bufptr-Parameter verweist auf eine SERVER_TRANSPORT_INFO_0-Struktur .

[in] bufptr

Ein Zeiger auf den Puffer, der die Daten enthält.

Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen.
ERROR_DUP_NAME	Im Netzwerk ist ein doppelter Name vorhanden.
ERROR_INVALID_DOMAINNAME	Der Domänenname wurde im Netzwerk nicht gefunden.
ERROR_INVALID_LEVEL	Der für den level-Parameter angegebene Wert ist ungültig.
ERROR_INVALID_PARAMETER	Ein Parameter ist ungültig. Dieser Fehler wird zurückgegeben, wenn der svti0_transportname oder svti0_transportaddress Member in der SERVER_TRANSPORT_INFO_0-Struktur , auf die der bufptr-Parameter verweist, NULL ist. Dieser Fehler wird auch zurückgegeben, wenn der svti0_transportaddresslength-Member in der SERVER_TRANSPORT_INFO_0-Struktur , auf die der bufptr-Parameter verweist, null oder größer als MAX_PATH (definiert in der Windef.h-Headerdatei) ist. Dieser Fehler wird auch für andere ungültige Parameter zurückgegeben.
ERROR_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher ist verfügbar.

Hinweise

Nur Mitglieder der lokalen Gruppe Administratoren oder Serveroperatoren können die NetServerTransportAdd-Funktion erfolgreich ausführen.

Wenn Sie einem Server mithilfe eines Aufrufs der NetServerTransportAdd-Funktion ein Transportprotokoll hinzufügen, bleibt die Verbindung nicht erhalten, nachdem der Server neu gestartet oder neu gestartet wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmserver.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll