Freigeben über

CONNECTDLGSTRUCTW-Struktur (winnetwk.h)

  • Artikel

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

Syntax

typedef struct _CONNECTDLGSTRUCTW {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEW lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTW, *LPCONNECTDLGSTRUCTW;

Member

cbStructure

Art: DWORD

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

hwndOwner

Typ: HWND

Das Handle zum Besitzerfenster für das Dialogfeld.

lpConnRes

Typ: LPNETRESOURCE

Ein Zeiger auf eine NETRESOURCE-Struktur .

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

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

dwFlags

Art: DWORD

Eine Reihe von Bitflags, die Optionen für die Dialogfeldanzeige 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 zu erlauben, einen Pfad einzugeben.

Dieses Flag sollte nur festgelegt werden, wenn das lpRemoteName-Member der NETRESOURCE-Struktur , auf die vom lpConnRes-Member verwiesen wird, nicht NULL (oder eine leere Zeichenfolge) ist und das CONNDLG_USE_MRU-Flag 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 Funktion WNetConnectionDialog1 erfolgreich ist, gibt dieses Mitglied 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 des CONNDLG_RO_PATH Dialogfelds verwendet.

Die werte CONNDLG_PERSIST und CONNDLG_NOT_PERSIST können nicht beide festgelegt werden. Wenn keines 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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]
Kopfzeile winnetwk.h

Weitere Informationen

NETRESOURCE

WNetConnectionDialog1

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkstrukturen