Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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 |
|---|---|
|
Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen. |
|
Im Netzwerk ist ein doppelter Name vorhanden. |
|
Der Domänenname wurde im Netzwerk nicht gefunden. |
|
Der für den level-Parameter angegebene Wert ist ungültig. |
|
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. |
|
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 |