NetWkstaTransportAdd-Funktion (lmwksta.h)

[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.

[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.

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.

Requirements (Anforderungen)