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