Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |