DISCDLGSTRUCTW-Struktur (winnetwk.h)

Artikel
03/04/2024

Die DISCDLGSTRUCT-Struktur wird in der Funktion WNetDisconnectDialog1 verwendet. Die Struktur enthält die erforderlichen Informationen für den Verbindungsversuch.

Syntax

typedef struct _DISCDLGSTRUCTW {
  DWORD  cbStructure;
  HWND   hwndOwner;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  DWORD  dwFlags;
} DISCDLGSTRUCTW, *LPDISCDLGSTRUCTW;

Member

cbStructure

Art: DWORD

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

hwndOwner

Typ: HWND

Ein Handle für das Besitzerfenster des Dialogfelds.

lpLocalName

Typ: LPTSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den lokalen Gerätenamen angibt, der an die Netzwerkressource umgeleitet wird, z. B. "F:" oder "LPT1".

lpRemoteName

Typ: LPTSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen der Netzwerkressource angibt, die getrennt werden soll. Dieses Element kann NULL sein, wenn das lpLocalName-Element angegeben ist. Wenn lpLocalName angegeben wird, wird die Verbindung mit der Netzwerkressource, die von lpLocalName umgeleitet wird, getrennt.

dwFlags

Art: DWORD

Eine Reihe von Bitflags, die die Verbindung beschreiben. Dieser Member kann eine Kombination der folgenden Werte sein.

Wert	Bedeutung
DISC_UPDATE_PROFILE	Wenn dieser Wert festgelegt ist, ist die angegebene Verbindung nicht mehr persistent (wird bei jeder Anmeldung des Benutzers automatisch wiederhergestellt). Dieses Flag ist nur gültig, wenn das lpLocalName-Element ein lokales Gerät angibt.
DISC_NO_FORCE	Wenn dieser Wert nicht festgelegt ist, wendet das System beim Versuch, die Verbindung mit der Netzwerkressource zu trennen, mit Kraft an. Diese Situation tritt in der Regel auf, wenn der Benutzer Dateien über die Verbindung geöffnet hat. Dieser Wert bedeutet, dass der Benutzer informiert wird, wenn offene Dateien in der Verbindung vorhanden sind, und gefragt wird, ob er oder sie weiterhin die Verbindung trennen möchte. Wenn der Benutzer fortfahren möchte, versucht die Trennungsprozedur mit zusätzlicher Kraft erneut.

Wert

Bedeutung

DISC_UPDATE_PROFILE

Wenn dieser Wert festgelegt ist, ist die angegebene Verbindung nicht mehr persistent (wird bei jeder Anmeldung des Benutzers automatisch wiederhergestellt). Dieses Flag ist nur gültig, wenn das lpLocalName-Element ein lokales Gerät angibt.

DISC_NO_FORCE

Wenn dieser Wert nicht festgelegt ist, wendet das System beim Versuch, die Verbindung mit der Netzwerkressource zu trennen, mit Kraft an.

Diese Situation tritt in der Regel auf, wenn der Benutzer Dateien über die Verbindung geöffnet hat. Dieser Wert bedeutet, dass der Benutzer informiert wird, wenn offene Dateien in der Verbindung vorhanden sind, und gefragt wird, ob er oder sie weiterhin die Verbindung trennen möchte. Wenn der Benutzer fortfahren möchte, versucht die Trennungsprozedur mit zusätzlicher Kraft erneut.

Hinweise

Hinweis

Der winnetwk.h-Header definiert DISCDLGSTRUCT 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 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

WNetDisconnectDialog1

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkstrukturen

Freigeben über