Freigeben über


WNetConnectionDialog1A-Funktion (winnetwk.h)

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

Weitere Informationen

CONNECTDLGSTRUCT

NETRESOURCE

WNetConnectionDialog

WNetDisconnectDialog

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkfunktionen