CONNECTDLGSTRUCTW-Struktur (winnetwk.h)
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 |
---|---|
|
Das Konto ist ein Benutzerkonto. |
|
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. |
|
Internes Flag. Nicht verwenden. |
|
Geben Sie die zuletzt verwendeten Pfade in das Kombinationsfeld ein. Legen Sie diesen Wert fest, um die WNetConnectionDialog-Funktion zu simulieren. |
|
Aktivieren Sie das Kontrollkästchen, 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
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 |