WNetDisconnectDialog1A-Funktion (winnetwk.h)
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 |
---|---|
|
Als das System den Benutzer zur Entscheidung über die Trennung aufforderte, hat sich der Benutzer dafür entschieden, die Verbindung nicht zu trennen. |
|
Die Verbindung kann nicht getrennt werden, da der Benutzer die Verbindung aktiv verwendet. |
|
Der Netzwerkanbieter ist ausgelastet (möglicherweise initialisiert). Der Aufrufer sollte es wiederholen. |
|
Das Netzwerk ist nicht verfügbar. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um das Dialogfeld zu starten. |
|
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 |