WNetConnectionDialog1W-Funktion (winnetwk.h)
Mit der WNetConnectionDialog1-Funktion wird ein allgemeines Browserdialogfeld zum Herstellen einer Verbindung mit Netzwerkressourcen angezeigt. Für die Funktion ist eine CONNECTDLGSTRUCT erforderlich, um die Dialogfeldparameter einzurichten.
Syntax
DWORD WNetConnectionDialog1W(
[in, out] LPCONNECTDLGSTRUCTW lpConnDlgStruct
);
Parameter
[in, out] lpConnDlgStruct
Zeiger auf eine CONNECTDLGSTRUCT-Struktur . Die Struktur legt die Parameter des Browserdialogfelds fest.
Rückgabewert
Wenn der Benutzer das Dialogfeld abbricht, gibt die Funktion –1 zurück. Wenn die Funktion erfolgreich ist, gibt sie NO_ERROR zurück. Wenn der Aufruf erfolgreich ist, enthält das dwDevNum-Element der CONNECTDLGSTRUCT-Struktur außerdem die Nummer des verbundenen Geräts.
In der Regel gibt dieses Dialogfeld nur dann einen Fehler zurück, wenn der Benutzer keine Dialogsitzung eingeben kann. Dies liegt daran, dass Fehler, die nach einer Dialogsitzung auftreten, direkt an den Benutzer gemeldet werden. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.
Rückgabecode | Beschreibung |
---|---|
|
Sowohl die CONNDLG_RO_PATH- als auch die CONNDLG_USE_MRU-Dialogfeldoptionen sind festgelegt. (Dialogfeldoptionen werden vom dwFlags-Member der CONNECTDLGSTRUCT-Struktur angegeben.) Oder Sowohl die Optionen CONNDLG_PERSIST als auch die CONNDLG_NOT_PERSIST Dialogfelds sind festgelegt. Oder Die Option CONNDLG_RO_PATH Dialogfelds ist festgelegt, und das lpRemoteName-Element der NETRESOURCE-Struktur zeigt nicht auf ein Remotenetzwerk. (Die CONNECTDLGSTRUCT-Struktur verweist auf eine NETRESOURCE-Struktur .) |
|
Das dwType-Element der NETRESOURCE-Struktur ist nicht auf RESOURCETYPE_DISK festgelegt. |
|
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 anzuzeigen. |
|
Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie WNetGetLastError auf, um eine Beschreibung des Fehlers zu erhalten. |
Hinweise
Hinweis
Der winnetwk.h-Header definiert WNetConnectionDialog1 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
Anforderung | Wert |
---|---|
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für