DISCDLGSTRUCTA-Struktur (winnetwk.h)

Artikel
03/04/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;

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-endende Zeichenfolge, die den namen des lokalen Geräts angibt, das 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. Dieser Member kann NULL sein, wenn das lpLocalName-Element angegeben ist. Wenn lpLocalName angegeben wird, wird die Verbindung mit der Netzwerkressource getrennt, die von lpLocalName umgeleitet wird.

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 dauerhaft (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 Kraft an, wenn versucht wird, die Verbindung mit der Netzwerkressource zu trennen. 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 die Verbindung geöffnet ist, und gefragt wird, ob er die Verbindung noch 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 nicht mehr dauerhaft (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 Kraft an, wenn versucht wird, die Verbindung mit der Netzwerkressource zu trennen.

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

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 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
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