NetWkstaTransportDel-Funktion (lmwksta.h)

Artikel
08/24/2023

[Diese Funktion ist veraltet. Um die Standardeinstellungen für Transportprotokolle manuell zu ändern, verwenden Sie das Dialogfeld Eigenschaften der Lokalen Bereichsverbindung im Ordner Netzwerk und DFÜ Connections.]

Wird nicht unterstützt.

Die NetWkstaTransportDel-Funktion hebt die Bindung des Transportprotokolls vom Umleitungsgeber auf. (Der Redirector ist die Software auf dem Clientcomputer, die Dateianforderungen an den Servercomputer generiert.)

Syntax

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportDel(
  [in] LMSTR servername,
  [in] LMSTR transportname,
  [in] DWORD ucond
);

Parameter

[in] servername

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

Diese Zeichenfolge muss mit \beginnen.

[in] transportname

Zeiger auf eine Zeichenfolge, die den Namen des Transportprotokolls angibt, das von der Umleitung getrennt werden soll.

[in] ucond

Gibt die Kraftebene an, die beim Trennen des Transportprotokolls von der Umleitung verwendet werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
USE_NOFORCE	Schlägt die Verbindung fehl, wenn offene Dateien in der Verbindung vorhanden sind.
USE_FORCE	Schlägt die Verbindung fehl, wenn offene Dateien in der Verbindung vorhanden sind.
USE_LOTS_OF_FORCE	Schließen Sie alle geöffneten Dateien, und löschen Sie die Verbindung.

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_INVALID_PARAMETER	Einer der Funktionsparameter ist ungültig.
NERR_UseNotFound	Die Netzwerkverbindung ist nicht vorhanden.

Hinweise

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

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	lmwksta.h (include Lm.h, Lmwksta.h)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Share via