WNetDisconnectDialog1A-Funktion (winnetwk.h)

Artikel
11/20/2024

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. Für die Funktion ist ein DISCDLGSTRUCT- erforderlich, 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, lautet 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	Wenn das System den Benutzer zur Entscheidung über die Trennung aufgefordert hat, hat der Benutzer die Verbindung nicht getrennt.
ERROR_OPEN_FILES	Die Verbindung kann nicht getrennt werden, da der Benutzer die Verbindung aktiv verwendet.
ERROR_BUSY	Der Netzwerkanbieter ist ausgelastet (möglicherweise initialisieren). Der Anrufer sollte erneut versuchen.
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.

Bemerkungen

Anmerkung

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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winnetwk.h
Library	Mpr.lib
DLL-	Mpr.dll