NetUseDel-Funktion (lmuse.h)

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

Weitere Informationen

NetUseAdd

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Verwenden von Funktionen

WNetCancelConnection2