WNetConnectionDialog1A-Funktion (winnetwk.h)

Artikel
08/27/2023

Die WNetConnectionDialog1-Funktion öffnet ein allgemeines Browserdialogfeld zum Herstellen einer Verbindung mit Netzwerkressourcen. Für die Funktion ist eine CONNECTDLGSTRUCT erforderlich, um die Dialogfeldparameter festzulegen.

Syntax

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

Parameter

[in, out] lpConnDlgStruct

Zeiger auf eine CONNECTDLGSTRUCT-Struktur . Die -Struktur richtet die Parameter des Browserdialogs ein.

Rückgabewert

Wenn der Benutzer das Dialogfeld abbricht, gibt die Funktion –1 zurück. Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Wenn der Aufruf erfolgreich ist, enthält der dwDevNum-Member 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, dem Benutzer direkt gemeldet werden. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Sowohl die optionen CONNDLG_RO_PATH als auch die CONNDLG_USE_MRU Dialogfelds sind festgelegt. (Dialogfeldoptionen werden vom dwFlags-Element 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 der lpRemoteName-Member der NETRESOURCE-Struktur verweist nicht auf ein Remotenetzwerk. (Die CONNECTDLGSTRUCT-Struktur verweist auf eine NETRESOURCE-Struktur .)
ERROR_BAD_DEV_TYPE	Das dwType-Element der NETRESOURCE-Struktur ist nicht auf RESOURCETYPE_DISK festgelegt.
ERROR_BUSY	Der Netzwerkanbieter ist ausgelastet (möglicherweise initialisiert). Der Aufrufer sollte den Vorgang wiederholen.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar.
ERROR_NOT_ENOUGH_MEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um das Dialogfeld anzuzeigen.
ERROR_EXTENDED_ERROR	Ein netzwerkspezifischer Fehler ist 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 Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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