Freigeben über


WNetConnectionDialog-Funktion (winnetwk.h)

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

Weitere Informationen

WNetAddConnection3

WNetCancelConnection2

WNetDisconnectDialog

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkfunktionen