CONNECTDLGSTRUCTA-Struktur (winnetwk.h)
Die CONNECTDLGSTRUCT- Struktur wird von der WNetConnectionDialog1-Funktion verwendet, um Browserdialogfeldparameter einzurichten.
Syntax
typedef struct _CONNECTDLGSTRUCTA {
DWORD cbStructure;
HWND hwndOwner;
LPNETRESOURCEA lpConnRes;
DWORD dwFlags;
DWORD dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;
Angehörige
cbStructure
Typ: DWORD-
Die Größe der CONNECTDLGSTRUCT Struktur in Byte. 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 das lpRemoteName Mitglied 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. Der dwType Member muss RESOURCETYPE_DISK entsprechen.
Das System unterstützt das RESOURCETYPE_PRINT Flag zum Durchsuchen und Herstellen einer Verbindung mit Druckressourcen nicht.
dwFlags
Typ: DWORD-
Eine Reihe von Bitkennzeichnungen, die Optionen für die Anzeige des Dialogfelds beschreiben. Dieses Element kann eine Kombination aus den folgenden Werten sein.
| Wert | Bedeutung |
|---|---|
|
Das Konto ist ein Benutzerkonto. |
|
Zeigen Sie einen schreibgeschützten Pfad an, anstatt dem Benutzer die Eingabe in einen Pfad zu gestatten.
Dieses Flag sollte nur festgelegt werden, wenn das lpRemoteName- Mitglied der NETRESOURCE- Struktur, auf die durch lpConnRes Member verwiesen wird, nicht NULL- (oder eine leere Zeichenfolge) und das CONNDLG_USE_MRU Flag nicht festgelegt ist. |
|
Interne Kennzeichnung. Nicht verwenden. |
|
Geben Sie die zuletzt verwendeten Pfade in das Kombinationsfeld ein. Legen Sie diesen Wert fest, um die WNetConnectionDialog--Funktion zu simulieren. |
|
Zeigen Sie das Kontrollkästchen an, mit dem der Benutzer die Verbindung bei der Anmeldung wiederherstellen kann. |
|
Stellen Sie die Verbindung bei der Anmeldung wieder her. |
|
Stellen Sie die Verbindung bei der Anmeldung nicht wieder her. |
Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
dwDevNum
Typ: DWORD-
Wenn der Aufruf der WNetConnectionDialog1-Funktion erfolgreich ist, gibt dieses Element 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, lautet der Wert –1.
Bemerkungen
Wenn weder das CONNDLG_RO_PATH noch das CONNDLG_USE_MRU Flag festgelegt ist, und das lpRemoteName Mitglied der NETRESOURCE--Struktur keinen Remotepfad angibt, wird standardmäßig der Anzeigetyp des dialogfelds CONNDLG_RO_PATH angefordert.
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 bestimmten Geräteverbindungstyp ausgewählt wurde.
Anmerkung
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 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] |
| Header- | winnetwk.h |
Siehe auch
übersicht über Windows Networking (WNet)