WNetConnectionDialog1A-Funktion (winnetwk.h)

Artikel
11/20/2024

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

Syntax

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

Parameter

[in, out] lpConnDlgStruct

Zeiger auf eine CONNECTDLGSTRUCT Struktur. Die Struktur richtet die Parameter für das Browserdialogfeld 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 Mitglied der CONNECTDLGSTRUCT- Struktur die Nummer des verbundenen Geräts.

In der Regel gibt dieses Dialogfeld nur dann einen Fehler zurück, wenn der Benutzer keine Dialogfeldsitzung 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 CONNDLG_RO_PATH als auch die Optionen für das Dialogfeld CONNDLG_USE_MRU werden festgelegt. (Dialogfeldoptionen werden durch das dwFlags Member der CONNECTDLGSTRUCT Struktur angegeben.) -oder- Sowohl die CONNDLG_PERSIST als auch die Optionen für das Dialogfeld CONNDLG_NOT_PERSIST werden festgelegt. -oder- Die Option CONNDLG_RO_PATH Dialogfelds wird festgelegt, und das lpRemoteName Mitglied der NETRESOURCE--Struktur verweist nicht auf ein Remotenetzwerk. (Die CONNECTDLGSTRUCT Struktur verweist auf eine NETRESOURCE--Struktur.)
ERROR_BAD_DEV_TYPE	Das dwType- Mitglied der NETRESOURCE--Struktur ist nicht auf RESOURCETYPE_DISK festgelegt.
ERROR_BUSY	Der Netzwerkanbieter ist ausgelastet (möglicherweise initialisieren). Der Anrufer sollte erneut versuchen.
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	Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie WNetGetLastError- auf, um eine Beschreibung des Fehlers abzurufen.

Bemerkungen

Anmerkung

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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winnetwk.h
Library	Mpr.lib
DLL-	Mpr.dll