NETINFOSTRUCT-Struktur (winnetwk.h)

Die NETINFOSTRUCT-Struktur enthält Informationen zur Beschreibung des Netzwerkanbieters, der von der Funktion WNetGetNetworkInformation zurückgegeben wird.

Syntax

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

Member

cbStructure

Art: DWORD

Die Größe der NETINFOSTRUCT-Struktur in Bytes. Der Aufrufer muss diesen Wert angeben, um die Größe der übergebenen Struktur anzugeben. Nach der Rückgabe wird die Größe der Struktur ausgefüllt.

dwProviderVersion

Art: DWORD

Die Versionsnummer der Netzwerkanbietersoftware.

dwStatus

Art: DWORD

Die aktuelle status der Netzwerkanbietersoftware. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
NO_ERROR	Das Netzwerk wird ausgeführt.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar.
ERROR_BUSY	Das Netzwerk ist derzeit nicht in der Lage, Anforderungen zu verarbeiten, sollte jedoch in Kürze verfügbar sein. (Dieser Wert gibt in der Regel an, dass das Netzwerk gestartet wird.)

dwCharacteristics

Art: DWORD

Merkmale der Software des Netzwerkanbieters.

Dieser Wert ist 0.

Windows Me/98/95: Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
NETINFO_DLL16	Der Netzwerkanbieter wird als 16-Bit-Windows-Netzwerktreiber ausgeführt.
NETINFO_DISKRED	Der Netzwerkanbieter benötigt ein umgeleitetes lokales Datenträgerlaufwerk für den Zugriff auf Serverdateisysteme.
NETINFO_PRINTERRED	Der Netzwerkanbieter benötigt einen umgeleiteten lokalen Druckerport für den Zugriff auf Serverdateisysteme.

dwHandle

Typ: ULONG_PTR

Ein instance Handle für den Netzwerkanbieter oder für den 16-Bit-Windows-Netzwerktreiber.

wNetType

Typ: WORD

Der Netzwerktyp, der für das ausgeführte Netzwerk eindeutig ist. Dieser Wert ordnet Ressourcen einem bestimmten Netzwerk zu, wenn die Ressourcen persistent sind oder in Links gespeichert sind. Eine vollständige Liste der Netzwerktypen finden Sie in der Headerdatei Winnetwk.h.

dwPrinters

Art: DWORD

Eine Reihe von Bitflags, die die gültigen Drucknummern für die Umleitung lokaler Druckergeräte angeben, wobei das Bit mit niedriger Reihenfolge LPT1 entspricht.

Windows Me/98/95: Dieser Wert ist immer auf –1 festgelegt.

dwDrives

Art: DWORD

Eine Reihe von Bitflags, die die gültigen lokalen Datenträgergeräte für die Umleitung von Datenträgerlaufwerken angeben, wobei das Bit mit niedriger Reihenfolge A:entspricht.

Windows Me/98/95: Dieser Wert ist immer auf –1 festgelegt.

Hinweise

Die NETINFOSTRUCT-Struktur enthält Informationen, die das Netzwerk beschreiben, z. B. die Version der Netzwerkanbietersoftware und die aktuelle status des Netzwerks.

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

WNetGetNetWorkInformation

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkstrukturen