Freigeben über

DISCDLGSTRUCTW-Struktur (winnetwk.h)

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

Syntax

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

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.

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

  • Last updated on