NetUseDel-Funktion (lmuse.h)

Artikel
08/24/2023

Die NetUseDel-Funktion beendet eine Verbindung mit einer freigegebenen Ressource.

Sie können auch die WNetCancelConnection2-Funktion verwenden, um eine Netzwerkverbindung zu beenden.

Syntax

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

Parameter

[in] UncServerName

Der UNC-Name des Computers, auf dem diese Funktion ausgeführt werden soll. Wenn der 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] UseName

Ein Zeiger auf eine Zeichenfolge, die den Pfad der zu löschenden Verbindung angibt.

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

[in] ForceLevelFlags

Die Erzwingungsebene, die beim Löschen der Verbindung verwendet werden soll.

Dieser Parameter kann einer der folgenden Werte sein, die in der Headerdatei lmuseflg.h definiert sind.

Wert	Bedeutung
USE_NOFORCE	Schlägt die Verbindung fehl, wenn offene Dateien in der Verbindung vorhanden sind.
USE_FORCE	Schlägt die Verbindung nicht 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, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Die NetUseDel-Funktion gilt nur für den Client server Message Block (LAN Manager Workstation). Die NetUseDel-Funktion unterstützt keine DFS-Freigaben (Distributed File System) oder andere Netzwerkdateisysteme. Verwenden Sie die WNetCancelConnection2-Funktion , um eine Verbindung mit einer Freigabe mit einem anderen Netzwerkanbieter (z. B. WebDAV oder DFS-Freigabe) zu beenden.

Zum Aufrufen der NetUseDel-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.

Anforderungen


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