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 |
|---|---|
|
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 |
|---|---|
|
Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie die WNetGetLastError-Funktion auf, um eine Beschreibung des Fehlers zu erhalten. |
|
Das angegebene Kennwort ist ungültig. |
|
Das Netzwerk ist nicht verfügbar. |
|
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 |