WNetDisconnectDialog1A-Funktion (winnetwk.h)

Artikel
08/27/2023

Die WNetDisconnectDialog1-Funktion versucht, eine Netzwerkressource zu trennen. Wenn das zugrunde liegende Netzwerk ERROR_OPEN_FILES zurückgibt, fordert die Funktion den Benutzer zur Bestätigung auf. Wenn ein Fehler auftritt, informiert die Funktion den Benutzer. Die Funktion erfordert eine DISCDLGSTRUCT , um die Parameter für den Verbindungsversuch anzugeben.

Syntax

DWORD WNetDisconnectDialog1A(
  [in] LPDISCDLGSTRUCTA lpConnDlgStruct
);

Parameter

[in] lpConnDlgStruct

Zeiger auf eine DISCDLGSTRUCT-Struktur . Die Struktur gibt das Verhalten für den Verbindungsversuch an.

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_CANCELLED	Als das System den Benutzer zur Entscheidung über die Trennung aufforderte, hat sich der Benutzer dafür entschieden, die Verbindung nicht zu trennen.
ERROR_OPEN_FILES	Die Verbindung kann nicht getrennt werden, da der Benutzer die Verbindung aktiv verwendet.
ERROR_BUSY	Der Netzwerkanbieter ist ausgelastet (möglicherweise initialisiert). Der Aufrufer sollte es wiederholen.
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.
ERROR_EXTENDED_ERROR	Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie die WNetGetLastError-Funktion auf, um eine Beschreibung des Fehlers abzurufen.

Hinweise

Hinweis

Der winnetwk.h-Header definiert WNetDisconnectDialog1 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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