NetWkstaTransportAdd-Funktion (lmwksta.h)

Artikel
08/24/2023

[Diese Funktion ist veraltet. Um die Standardeinstellungen für Transportprotokolle manuell zu ändern, verwenden Sie das Dialogfeld Local Area Connection Properties im Ordner Netzwerk- und DFÜ-Verbindungen .]

Wird nicht unterstützt.

Die NetWkstaTransportAdd-Funktion bindet (oder verbindet) den Umleitungsor an den Transport. Der Redirector ist die Software auf dem Clientcomputer, die Dateianforderungen an den Servercomputer generiert.

Syntax

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

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] level

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

Wert	Bedeutung
0	Gibt Informationen zum Arbeitsstationstransportprotokoll an. Der buf-Parameter verweist auf eine WKSTA_TRANSPORT_INFO_0-Struktur .

[in] buf

Zeiger auf den Puffer, der die Daten angibt. Das Format dieser Daten hängt vom Wert des level-Parameters ab. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.

[out] parm_err

Zeiger auf einen Wert, der den Index des ersten Parameters empfängt, der den ERROR_INVALID_PARAMETER Fehler verursacht. Wenn dieser Parameter NULL ist, wird der Index nicht bei einem Fehler zurückgegeben.

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_LEVEL	Der level-Parameter, der angibt, welche Ebene von Datenstrukturinformationen verfügbar ist, ist ungültig.
ERROR_INVALID_PARAMETER	Einer der Funktionsparameter ist ungültig.

Hinweise

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

Wenn die NetWkstaTransportAdd-Funktion ERROR_INVALID_PARAMETER zurückgibt, können Sie den parameter parm_err verwenden, um den ungültigen Member der WKSTA_TRANSPORT_INFO_0-Struktur anzugeben. In der folgenden Tabelle sind die Werte aufgeführt, die im parm_err-Parameter und dem entsprechenden Strukturmember zurückgegeben werden können, der fehlerhaft ist.

Wert	Member
TRANSPORT_QUALITYOFSERVICE_PARMNUM	wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM	wkti0_transport_name

Requirements (Anforderungen)


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

Freigeben über