Freigeben über


NetServerTransportAdd-Funktion (lmserver.h)

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

Weitere Informationen

NetServerComputerNameAdd

NetServerComputerNameDel

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SERVER_TRANSPORT_INFO_3

Server- und Arbeitsstationstransportfunktionen