DISCDLGSTRUCTA-Struktur (winnetwk.h)

Artikel
11/20/2024

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

Syntax

typedef struct _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

Angehörige

cbStructure

Typ: DWORD-

Die Größe der DISCDLGSTRUCT Struktur in Byte. 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--terminated-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--terminated-Zeichenfolge, die den Namen der Netzwerkressource angibt, die getrennt werden soll. Dieses Element kann NULL sein, wenn das lpLocalName Member angegeben ist. Wenn lpLocalName- angegeben wird, wird die Verbindung mit der Netzwerkressource, die von lpLocalName umgeleitet wird, getrennt.

dwFlags

Typ: DWORD-

Eine Gruppe von Bitkennzeichnungen, die die Verbindung beschreiben. Dieses Element kann eine Kombination aus den folgenden Werten sein.

Wert	Bedeutung
DISC_UPDATE_PROFILE	Wenn dieser Wert festgelegt ist, ist die angegebene Verbindung keine dauerhafte Verbindung mehr (wird bei jeder Anmeldung des Benutzers automatisch wiederhergestellt). Dieses Flag ist nur gültig, wenn das lpLocalName Member ein lokales Gerät angibt.
DISC_NO_FORCE	Wenn dieser Wert nicht festgelegt ist, wird das System beim Versuch, die Verbindung mit der Netzwerkressource zu trennen, erzwungen. 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, ob die Verbindung geöffnete Dateien enthält, und gefragt wird, ob er die Verbindung trotzdem trennen möchte. Wenn der Benutzer fortfahren möchte, versucht die Trennungsprozedur erneut mit zusätzlicher Kraft.

Wert

Bedeutung

DISC_UPDATE_PROFILE

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

DISC_NO_FORCE

Wenn dieser Wert nicht festgelegt ist, wird das System beim Versuch, die Verbindung mit der Netzwerkressource zu trennen, erzwungen.

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, ob die Verbindung geöffnete Dateien enthält, und gefragt wird, ob er die Verbindung trotzdem trennen möchte. Wenn der Benutzer fortfahren möchte, versucht die Trennungsprozedur erneut mit zusätzlicher Kraft.

Bemerkungen

Anmerkung

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

WNetDisconnectDialog1-

übersicht über Windows Networking (WNet)

Windows-Netzwerkstrukturen

Freigeben über