WNetDisconnectDialog-Funktion (winnetwk.h)

Artikel
08/27/2023

Die WNetDisconnectDialog-Funktion startet ein allgemeines Browserdialogfeld zum Trennen von Netzwerkressourcen. Für die Funktion ist ein Handle für das Besitzerfenster für das Dialogfeld erforderlich.

Syntax

DWORD WNetDisconnectDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

Parameter

[in] hwnd

Handle mit dem Besitzerfenster für das Dialogfeld.

[in] dwType

Ressourcentyp, von dem die Verbindung getrennt werden soll. Dieser Parameter kann den folgenden Wert aufweisen.

Wert	Bedeutung
RESOURCETYPE_DISK	Trennt die Verbindung mit Datenträgerressourcen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR. Wenn der Benutzer das Dialogfeld abbricht, ist der Rückgabewert –1.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.

Rückgabecode	Beschreibung
ERROR_EXTENDED_ERROR	Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie die WNetGetLastError-Funktion auf, um eine Beschreibung des Fehlers zu erhalten.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar.
ERROR_NOT_ENOUGH_MEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um das Dialogfeld zu starten.

Hinweise

Die WNetDisconnectDialog-Funktion gibt sofort zurück und erstellt ein Dialogfeld zum Trennen von Netzwerklaufwerken. Dieses Dialogfeld wird asynchron in einem Workerthread ausgeführt.

Wenn der Workerthread beendet wird, werden auch das Besitzerfenster und das zugehörige Dialogfeld beendet. In diesem Fall kann der Benutzer möglicherweise nicht mit dem Dialogfeld interagieren, da es nicht auf dem Bildschirm des Benutzers angezeigt wird oder kurz angezeigt wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winnetwk.h
Bibliothek	Mpr.lib
DLL	Mpr.dll