WNetConnectionDialog-Funktion (winnetwk.h)

Artikel
08/27/2023

Die WNetConnectionDialog-Funktion startet ein allgemeines Browserdialogfeld zum Herstellen einer Verbindung mit Netzwerkressourcen. Für die Funktion ist ein Handle für das Besitzerfenster für das Dialogfeld erforderlich.

Syntax

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

Parameter

[in] hwnd

Handle mit dem Besitzerfenster für das Dialogfeld.

[in] dwType

Ressourcentyp, mit dem Verbindungen zugelassen werden sollen. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
RESOURCETYPE_DISK	Verbindungen mit Datenträgerressourcen.

Rückgabewert

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

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_INVALID_PASSWORD	Das angegebene Kennwort ist ungültig.
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

Wenn der Benutzer im Dialogfeld auf OK klickt, wurde die angeforderte Netzwerkverbindung hergestellt, wenn die WNetConnectionDialog-Funktion zurückgegeben wird.

Wenn die Funktion versucht, eine Verbindung herzustellen und der Netzwerkanbieter die Nachricht ERROR_INVALID_PASSWORD zurückgibt, fordert das System den Benutzer zur Eingabe eines Kennworts auf. Das System verwendet das neue Kennwort bei einem anderen Versuch, die Verbindung herzustellen.

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