Freigeben über

CONNECTDLGSTRUCTA-Struktur (winnetwk.h)

  • Artikel

Die CONNECTDLGSTRUCT-Struktur wird von der WNetConnectionDialog1-Funktion verwendet, um Browserdialogfeldparameter festzulegen.

Syntax

typedef struct _CONNECTDLGSTRUCTA {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEA lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;

Member

cbStructure

Art: DWORD

Die Größe der CONNECTDLGSTRUCT-Struktur in Bytes. Der Aufrufer muss diesen Wert angeben.

hwndOwner

Typ: HWND

Das Handle für das Besitzerfenster für das Dialogfeld.

lpConnRes

Typ: LPNETRESOURCE

Ein Zeiger auf eine NETRESOURCE-Struktur .

Wenn der lpRemoteName-Member von NETRESOURCE angegeben wird, wird es in das Pfadfeld des Dialogfelds eingegeben. Mit Ausnahme des dwType-Elements müssen alle anderen Member der NETRESOURCE-Struktur auf NULL festgelegt werden. Der dwType-Member muss gleich RESOURCETYPE_DISK sein.

Das RESOURCETYPE_PRINT-Flag zum Durchsuchen und Herstellen einer Verbindung mit Druckressourcen wird vom System nicht unterstützt.

dwFlags

Art: DWORD

Eine Reihe von Bitflags, die Optionen für die Anzeige des Dialogfelds beschreiben. Dieser Member kann eine Kombination der folgenden Werte sein.

Wert Bedeutung
SidTypeUser
 Das Konto ist ein Benutzerkonto.
CONNDLG_RO_PATH
 Zeigen Sie einen schreibgeschützten Pfad an, anstatt dem Benutzer die Eingabe eines Pfads zu gestatten.

Dieses Flag sollte nur festgelegt werden, wenn das lpRemoteName-Element der NETRESOURCE-Struktur , auf die vom lpConnRes-Element verwiesen wird, nicht NULL (oder eine leere Zeichenfolge) ist und das flag CONNDLG_USE_MRU nicht festgelegt ist.
CONNDLG_CONN_POINT
 Internes Flag. Nicht verwenden.
CONNDLG_USE_MRU
 Geben Sie die zuletzt verwendeten Pfade in das Kombinationsfeld ein. Legen Sie diesen Wert fest, um die WNetConnectionDialog-Funktion zu simulieren.
CONNDLG_HIDE_BOX
 Aktivieren Sie das Kontrollkästchen, mit dem der Benutzer die Verbindung bei der Anmeldung wiederherstellen kann.
CONNDLG_PERSIST
 Stellen Sie die Verbindung bei der Anmeldung wieder her.
CONNDLG_NOT_PERSIST
 Stellen Sie die Verbindung bei der Anmeldung nicht wieder her.
 

Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

dwDevNum

Art: DWORD

Wenn der Aufruf der WNetConnectionDialog1-Funktion erfolgreich ist, gibt dieser Member die Nummer des verbundenen Geräts zurück. Der Wert ist 1 für A:, 2 für B:, 3 für C:usw. Wenn der Benutzer eine gerätelose Verbindung hergestellt hat, ist der Wert –1.

Hinweise

Wenn weder das CONNDLG_RO_PATH- noch das CONNDLG_USE_MRU-Flag festgelegt ist und das lpRemoteName-Element der NETRESOURCE-Struktur keinen Remotepfad angibt, wird für die Anforderung standardmäßig der Anzeigetyp CONNDLG_RO_PATH Dialogfelds verwendet.

Die werte CONNDLG_PERSIST und CONNDLG_NOT_PERSIST können nicht beide festgelegt werden. Wenn keines der beiden Optionen festgelegt ist, wird im Dialogfeld standardmäßig die letzte Option verwendet, die in diesem Dialogfeld für den jeweiligen Geräteverbindungstyp ausgewählt wurde.

Hinweis

Der winnetwk.h-Header definiert CONNECTDLGSTRUCT 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
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile winnetwk.h

Weitere Informationen

NETRESOURCE

WNetConnectionDialog1

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkstrukturen