NetUseAdd-Funktion (lmuse.h)

Artikel
08/24/2023

Die NetUseAdd-Funktion stellt eine Verbindung zwischen dem lokalen Computer und einem Remoteserver her. Sie können einen lokalen Laufwerkbuchstaben oder ein Druckergerät für die Verbindung angeben. Wenn Sie keinen lokalen Laufwerkbuchstaben oder Druckergerät angeben, authentifiziert die Funktion den Client beim Server für zukünftige Verbindungen.

Syntax

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

Parameter

[in] servername

Der UNC-Name des Computers, auf dem diese Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet. Wenn der angegebene UncServerName-Parameter ein Remotecomputer ist, muss der Remotecomputer RPC-Remoteaufrufe mithilfe des älteren Remotezugriffsprotokollmechanismus unterstützen.

Diese Zeichenfolge ist Unicode, wenn _WIN32_WINNT oder FORCE_UNICODE definiert sind.

[in] LevelFlags

Ein Wert, der die Informationsebene der Daten angibt. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
1	Gibt Informationen zur Verbindung zwischen einem lokalen Gerät und einer freigegebenen Ressource an. Informationen umfassen die verbindung status und den Typ. Der Buf-Parameter ist ein Zeiger auf eine USE_INFO_1 Struktur.
2	Gibt Informationen zur Verbindung zwischen einem lokalen Gerät und einer freigegebenen Ressource an. Informationen umfassen die Verbindung status und Typ sowie einen Benutzernamen und Domänennamen. Der Buf-Parameter ist ein Zeiger auf eine USE_INFO_2 Struktur.

[in] buf

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

[out] parm_err

Ein Zeiger auf einen Wert, der den Index des ersten Members der Informationsstruktur empfängt, wenn der ERROR_INVALID_PARAMETER Fehler zurückgegeben wird. Wenn dieser Parameter NULL ist, wird der Index nicht bei einem Fehler zurückgegeben. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Sie können auch die Funktionen WNetAddConnection2 und WNetAddConnection3 verwenden, um ein lokales Gerät an eine Netzwerkressource umzuleiten.

Zum Aufrufen der NetUseAdd-Funktion ist keine spezielle Gruppenmitgliedschaft erforderlich. Diese Funktion kann nicht auf einem Remoteserver ausgeführt werden, außer in Fällen der Abwärtskompatibilität.

Diese Funktion gilt nur für den Client server Message Block (LAN Manager Workstation). Die NetUseAdd-Funktion unterstützt keine DFS-Freigaben (Distributed File System). Verwenden Sie die Funktion WNetAddConnection2 oder WNetAddConnection3 , um eine Freigabe mit einem anderen Netzwerkanbieter (z. B. WebDAV oder DFS-Freigabe) hinzuzufügen.

Wenn die NetUseAdd-Funktion ERROR_INVALID_PARAMETER zurückgibt, können Sie den ParmError-Parameter verwenden, um das erste element der Informationsstruktur anzugeben, das ungültig ist. (Die Informationsstruktur beginnt mit USE_INFO_, und ihr Format wird durch den Parameter Level angegeben.) In der folgenden Tabelle sind die Werte aufgeführt, die im ParmError-Parameter zurückgegeben werden können, und dem entsprechenden Strukturmember, der fehlerhaft ist. (Das Präfix ui*_ gibt an, dass der Member mit mehreren Präfixen beginnen kann, z. B. ui1_ oder ui2_.)

Konstante	Wert	Member
USE_LOCAL_PARMNUM	1	ui*_local
USE_REMOTE_PARMNUM	2	ui*_remote
USE_PASSWORD_PARMNUM	3	ui*_password
USE_ASGTYPE_PARMNUM	4	ui*_asg_type
USE_USERNAME_PARMNUM	5	ui*_username
USE_DOMAINNAME_PARMNUM	6	ui*_domainname

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	lmuse.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll