Freigeben über

INTF_ENTRY-Struktur

  • Artikel

[INTF_ENTRY wird ab Windows Vista und Windows Server 2008 nicht mehr unterstützt. Verwenden Sie stattdessen die Native Wifi-API, die ähnliche Funktionen bereitstellt. Weitere Informationen finden Sie unter Informationen zur nativen Wifi-API.]

Enthält ausführliche Informationen zu einer Schnittstelle, die für einen RPC-Client erforderlich ist.

Syntax

typedef struct {
  LPWSTR   wszGuid;
  LPWSTR   wszDescr;
  DWORD    dwContext;
  ULONG    ulMediaState;
  ULONG    ulMediaType;
  ULONG    ulPhysicalMediaType;
  INT      nInfraMode;
  INT      nAuthMode;
  INT      nWepStatus;
  DWORD    dwCtlFlags;
  DWORD    dwDynFlags;
  DWORD    dwCapabilities;
  RAW_DATA rdNicCapabilities;
  RAW_DATA rdSSID;
  RAW_DATA rdBSSID;
  RAW_DATA rdBSSIDList;
  RAW_DATA rdStSSIDList;
  RAW_DATA rdCtrlData;
} INTF_ENTRY, *PINTF_ENTRY;

Member

wszGuid

Ein Zeiger auf die Schnittstellen-GUID, die als Unicode-Zeichenfolge im folgenden Format dargestellt wird: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx}".

wszDescr

Ein Zeiger auf eine Zeichenfolge, die die Schnittstellenbeschreibung enthält, die vom Wireless Zero Configuration Service (WZCSVC) abgerufen wird.

dwContext

Für die interne Verwendung reserviert.

ulMediaState

Der aktuelle NDIS-Medienverbindungsstatus für die Schnittstelle. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
MEDIA_STATE_CONNECTED
1
 Das Medium ist verbunden.
MEDIA_STATE_DISCONNECTED
0
 Die Medien werden getrennt.
MEDIA_STATE_UNKNOWN
-1
 Der Medienstatus ist unbekannt.

 

ulMediaType

Die NDIS-Medientypen, die die Netzwerkkarte derzeit verwendet. Bei Der Abfrage wird der Wert dieses Members NdisMedium802_3 , wie in der Ndispnp.h-Headerdatei definiert.

ulPhysicalMediaType

Der NDIS-Medientyp für die Schnittstelle. Wenn dieser Member abgefragt wird, lautet der Wert NdisPhysicalMediumWirelessLan , wie in der Headerdatei "Ndispnp.h " definiert.

nInfraMode

Der aktuelle 802.11-Infrastrukturmodus, der auf der Schnittstelle festgelegt ist.

nAuthMode

Der aktuelle 802.11-Authentifizierungsmodus, der auf der Schnittstelle festgelegt ist.

Die folgende Tabelle zeigt die möglichen Werte für den Parameter basierend auf der in der Headerdatei "NtDDNdis.h " definierten NDIS_802_11_AUTHENTICATION_MODE-Enumeration.

Wert Bedeutung
Ndis802_11AuthModeOpen
1
 IEEE 802.11 Open System-Authentifizierung.
Ndis802_11AuthModeShared
2
 Gemeinsame IEEE 802.11-Authentifizierung, die einen vorab freigegebenen WEP-Schlüssel (Wired Equivalent Privacy) verwendet.
Ndis802_11AuthModeAutoSwitch
3
 Auto-Switch-Modus. Wenn Sie den Modus für den automatischen Wechsel verwenden, versucht die drahtlose Netzwerkschnittstelle Karte (NIC) zuerst den freigegebenen Authentifizierungsmodus. Wenn der freigegebene Modus fehlschlägt, versucht die Netzwerkkarte, den offenen Authentifizierungsmodus zu verwenden.
Ndis802_11AuthModeWPA
4
 Wpa-Sicherheit (Wireless Protected Access). Die Authentifizierung wird zwischen dem Supplicant-, Authenticator- und Authentifizierungsserver über IEEE 802.1X durchgeführt. Verschlüsselungsschlüssel sind dynamisch und werden über den Authentifizierungsprozess abgeleitet.
Ndis802_11AuthModeWPAPSK
5
 WPA-Sicherheit mithilfe eines vorinstallierten Schlüssels. Die Authentifizierung wird zwischen supplicant und authenticator über IEEE 802.1X durchgeführt. Verschlüsselungsschlüssel sind dynamisch und werden über den vorab freigegebenen Schlüssel abgeleitet, der vom Supplicant und authenticator verwendet wird.
Ndis802_11AuthModeWPANone
6
 WPA-Sicherheit. Die Authentifizierung erfolgt mithilfe eines vorinstallierten Schlüssels ohne IEEE 802.1X-Authentifizierung. Verschlüsselungsschlüssel sind statisch und werden über den vorab freigegebenen Schlüssel abgeleitet. Dieser Modus gilt nur für Ad-hoc-Netzwerktypen.
Ndis802_11AuthModeWPA2
7
 WPA2-Sicherheit. Die Authentifizierung wird zwischen dem Supplicant-, Authenticator- und Authentifizierungsserver über IEEE 802.1X durchgeführt. Verschlüsselungsschlüssel sind dynamisch und werden über den Authentifizierungsprozess abgeleitet.
Ndis802_11AuthModeWPA2PSK
8
 Gibt die WPA2-Sicherheit an. Die Authentifizierung wird zwischen supplicant und authenticator über IEEE 802 1X durchgeführt. Verschlüsselungsschlüssel sind dynamisch und werden über den vorab freigegebenen Schlüssel abgeleitet, der vom Supplicant und authenticator verwendet wird.
Ndis802_11AuthModeMax
9
 Der maximal mögliche Wert für den NDIS_802_11_AUTHENTICATION_MODE-Enumerationswert . Dies ist kein gesetzlicher Wert für den Authentifizierungsmodus.

 

nWepStatus

Der aktuelle 802.11-Verschlüsselungsmodus, der auf der Schnittstelle festgelegt ist.

dwCtlFlags

Eine Bitmaske von Steuerelementflags, die angeben, wie WZCSVC auf der Schnittstelle funktioniert.

In der folgenden Tabelle sind die möglichen Bitwerte aufgeführt.

Wert Bedeutung
INTFCTL_CM_MASK
0x0007
 Eine Bitmaske für den Netzwerkfiltermodus. & INTFCTL_CM_MASK dwCtlFlags ergeben einen Wert vom Typ NDIS_802_11_NETWORK_INFRASTRUCTURE. Der resultierende Wert gibt an, ob WZCSVC nur eine Verbindung mit Infrastrukturnetzwerken, Adhoc-Netzwerken oder mit beiden Netzwerktypen herstellt.
INTFCTL_ENABLED
0x8000
 Gibt an, ob WZCSVC die Schnittstelle konfigurieren soll.
INTFCTL_FALLBACK
0x4000
 Wenn ein bevorzugtes Netzwerk nicht verfügbar ist, gibt dieser Wert an, ob WZCSVC die NIC automatisch so konfigurieren soll, dass sie einem verfügbaren Netzwerk zugeordnet wird.
INTFCTL_OIDSSUPP
0x2000
 Gibt an, ob der NIC-Treiber alle 802.11-OIDs unterstützt, die für die Funktion von WZCSVC erforderlich sind.
INTFCTL_VOLATILE
0x1000
 Gibt an, ob die Dienstparameter für diese Schnittstelle in der Registrierung beibehalten werden sollen.
Wenn dieser Wert festgelegt ist, sind diese Parameter flüchtig und sollten nicht in der Registrierung beibehalten werden.
INTFCTL_POLICY
0x0800
 Gibt an, ob die Dienstparameter für diese Schnittstelle von einer Gruppenrichtlinie gepusht werden.
Wenn dieser Wert festgelegt ist, werden die Dienstparameter per Gruppenrichtlinie auf den lokalen Computer gepusht.
INTFCTL_8021XSUPP
0x1000
 Gibt an, ob 802.1X-Unterstützung aktiviert ist.

 

dwDynFlags

Eine Bitmaske dynamischer Flags, die das dynamische (nicht persistente und nicht statische) Verhalten auf der Schnittstelle steuern.

Diese Bits sind nützlich, um dynamische, temporäre Änderungen an der Art und Weise auszulösen, wie WZCSVC auf der Schnittstelle agiert. Keines dieser Bits wird in der Registrierung beibehalten, sodass die Einstellungen einen Systemneustart oder eine Geräteabschaltung und -aktivierung nicht überstehen.

In der folgenden Tabelle sind die möglichen Bitwerte aufgeführt.

Wert Bedeutung
INTFDYN_NOSCAN
0x00000001
 Gibt an, dass der WZCSVC die Schnittstelle nicht anfordern soll, eine aktive Überprüfung durchzuführen, sondern stattdessen die zwischengespeicherten Werte im NIC-Treiber verwenden soll.

 

dwCapabilities

Gibt die Treiberfunktionen an.

Wert Bedeutung
INTFCAP_MAX_CIPHER_MASK
0x000000ff
 Die Bits niedrigerer Reihenfolge dieses Members werden verwendet, um die maximale Verschlüsselung anzugeben, die unterstützt wird. Die möglichen Werte sind einige der Enumerationswerte, die in der NDIS_802_11_WEP_STATUS-Struktur in der Im Windows SDK enthaltenen NtDDNdis.h-Headerdatei definiert sind.
Der Ndis802_11Encryption1Enabled Wert (2) gibt an, dass WEP unterstützt wird. TKIP und AES werden nicht unterstützt, und ein Übertragungsschlüssel ist möglicherweise verfügbar.
Der Ndis802_11Encryption2Enabled-Wert (9) gibt an, dass TKIP und WEP unterstützt werden. AES wird nicht unterstützt, und ein Übertragungsschlüssel ist verfügbar.
Der Ndis802_11Encryption3Enabled Wert (11) gibt an, dass AES, TKIP und WEP unterstützt werden und ein Übertragungsschlüssel verfügbar ist.
Die Ndis802_11EncryptionNotSupported (8) gibt an, dass der WEP-Schlüssel nicht unterstützt wird.
INTFCAP_SSN
0x00000100
 Gibt die Unterstützung für Simple Secure Network (SSN) an, das eine Teilmenge von 802.11i ist.
SSN ändert den Verschlüsselungsschlüssel in regelmäßigen Abständen, im Gegensatz zum WEP-Standard (Wired Equivalent Privacy), der einen statischen Schlüssel verwendet. Damit SSN funktioniert, sollte die maximal unterstützte Verschlüsselung mindestens TKIP sein. SSN wurde 2002 von einem Konsortium von Anbietern als Interimsansatz zur Verbesserung der Wlan-Sicherheit entwickelt, während der IEEE 802.11i-Standard fertiggestellt wurde.
INTFCAP_80211I
0x00000200
 Gibt die Unterstützung für den IEEE 802.11i-Standard an.

 

rdNicCapabilities

Eine Reihe von Funktionen für 802.11i.

Die WZCQueryInterface-Funktion gibt rdNicCapabilities-Daten zurück, wenn sie mit dem im dwInflags-Parameter übergebenen INTF_CAPABILITIES-Flag aufgerufen wird. Wenn der Funktionsaufruf erfolgreich ist, enthält das pData-Element der RAW_DATA-Struktur eine INTF_80211_CAPABILITY-Struktur .

rdSSID

Binärdaten, die die SSID 802.11 enthalten, die derzeit auf der Schnittstelle konfiguriert ist.

Die WZCQueryInterface-Funktion gibt rdSSID-Daten zurück, wenn sie mit dem im dwInflags-Parameter übergebenen INTF_SSID-Flag aufgerufen wird. Wenn der Funktionsaufruf erfolgreich ist, enthält das dwDataLen-Element der RAW_DATA-Struktur den SsidLength-Member einer NDIS_802_11_SSID-Struktur , und das pData-Element der RAW_DATA-Struktur enthält den Ssid-Member einer NDIS_802_11_SSID-Struktur .

Die NDIS_802_11_SSID-Struktur ist in der Headerdatei Ntddndis.h definiert.

rdBSSID

Binärdaten, die die für die Schnittstelle konfigurierte 802.11 BSSID enthalten.

Die WZCQueryInterface-Funktion gibt rdBSSID-Daten zurück, wenn sie mit dem im dwInflags-Parameter übergebenen INTF_BSSID-Flag aufgerufen wird. Wenn der Funktionsaufruf erfolgreich ist, enthält das dwDataLen-Element der RAW_DATA-Struktur die Größe einer NDIS_802_11_MAC_ADDRESS-Struktur , und der pData-Member der RAW_DATA-Struktur enthält die NDIS_802_11_MAC_ADDRESS-Struktur .

Die NDIS_802_11_MAC_ADDRESS-Struktur ist in der Headerdatei Ntddndis.h definiert.

rdBSSIDList

Binärdaten, die die Liste der zuletzt von WZCSVC abgerufenen BSSIDs enthalten.

Die WZCQueryInterface-Funktion gibt rdBSSIDList-Daten zurück, wenn sie mit dem im dwInflags-Parameter übergebenen INTF_BSSIDLIST-Flag aufgerufen wird. Wenn der Funktionsaufruf erfolgreich ist, enthält das dwDataLen-Element der RAW_DATA-Struktur die Länge des Puffers mit den zurückgegebenen Daten, und der pData-Member der RAW_DATA-Struktur enthält die WZC_802_11_CONFIG_LIST-Struktur .

rdStSSIDList

Binärdaten, die die Liste der bevorzugten Netzwerke enthalten, die für diese Schnittstelle konfiguriert sind.

Die WZCQueryInterface-Funktion gibt rdStSSIDList-Daten zurück, wenn sie mit dem im dwInflags-Parameter übergebenen INTF_PREFLIST-Flag aufgerufen wird. Wenn der Funktionsaufruf erfolgreich ist, enthält das dwDataLen-Element der RAW_DATA-Struktur die Länge des Puffers mit den zurückgegebenen Daten, und der pData-Member der RAW_DATA-Struktur enthält die WZC_802_11_CONFIG_LIST-Struktur .

Wenn eines der bevorzugten Netzwerke derzeit verbunden ist, ist für den dwCtlFlags-Member der WZC_WLAN_CONFIG-Struktur für das Netzwerk das bit WZCCTL_MEDIA_CONNECTED (0x0400) festgelegt.

rdCtrlData

Binärdaten, die mit anderen Steuerelementflags verwendet werden, wenn zusätzliche Parameter für die Schnittstelle festgelegt werden.

Bemerkungen

Die INTF_ENTRY-Struktur wird von den Funktionen WZCQueryInterface und WZCRefreshInterface verwendet.

Die RAW_DATA-Struktur ist wie folgt definiert:

typedef struct
{
    DWORD   dwDataLen;
    LPBYTE  pData;
} RAW_DATA, *PRAW_DATA;

Das pData-Element verweist auf Binärdaten. DwDataLen gibt die Anzahl der Byte an, auf die pData verweist.

Hinweis

Die Wzcsapi.h-Headerdatei ist im Windows SDK nicht verfügbar.

 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Ende des Supports (Client)
 Windows XP mit SP3
Ende des Supports (Server)
 Windows Server 2003
Header
Wzcsapi.h

Weitere Informationen

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface