_Structure d’entrée INTF

[INTF _ l’entrée n’est plus prise en charge à partir de Windows Vista et Windows Server 2008. Utilisez plutôt l' API WiFi Native, qui offre des fonctionnalités similaires. Pour plus d’informations, consultez à propos de l’API WiFi Native.]

Contient des informations détaillées sur une interface requise par un client RPC.

Syntaxe

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;

Membres

wszGuid

Pointeur vers le GUID d’interface représenté sous la forme d’une chaîne Unicode au format suivant : "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}".

wszDescr

Pointeur vers une chaîne qui contient la description d’interface récupérée par le service de configuration automatique sans fil (WZCSVC).

dwContext

Réservé à un usage interne.

ulMediaState

État de connexion du média NDIS actuel pour l’interface. Le tableau suivant répertorie les valeurs possibles.

Value Signification
État du support _ _ connecté
1
Le média est connecté.
Éléments multimédias _ ÉTAT _ déconnecté
0
Le média est déconnecté.
Éléments multimédias _ ÉTAT _ inconnu
-1
L’état du support est inconnu.

ulMediaType

Types de média NDIS que la carte réseau utilise actuellement. Lorsqu’il est interrogé, la valeur de ce membre est NdisMedium802 _ 3 , comme défini dans le fichier d’en-tête Ndispnp. h .

ulPhysicalMediaType

Type de média NDIS pour l’interface. Lors de la requête, la valeur de ce membre est NdisPhysicalMediumWirelessLan comme défini dans le fichier d’en-tête Ndispnp. h .

nInfraMode

Mode d’infrastructure actuel 802,11 défini sur l’interface.

nAuthMode

Mode d’authentification 802,11 actuel défini sur l’interface.

Le tableau suivant indique les valeurs possibles pour le paramètre en fonction de l’énumération du _ _ _ _ mode d’authentification NDIS 802 11 définie dans le fichier d’en-tête NtDDNdis. h .

Valeur Signification
Ndis802 _ 11AuthModeOpen
1
Authentification système Open IEEE 802,11.
Ndis802 _ 11AuthModeShared
2
Authentification partagée IEEE 802,11 qui utilise une clé WEP (Wired Equivalent Privacy) prépartagée.
Ndis802 _ 11AuthModeAutoSwitch
3
Mode de basculement automatique. Lorsque vous utilisez le mode de basculement automatique, la carte d’interface réseau (NIC) sans fil tente d’abord d’utiliser le mode d’authentification partagé. Si le mode partagé échoue, la carte réseau tente d’utiliser le mode d’authentification ouvert.
Ndis802 _ 11AuthModeWPA
4
Sécurité WPA (Wireless Protected Access). L’authentification est effectuée entre le demandeur, l’authentificateur et le serveur d’authentification sur IEEE 802.1 X. Les clés de chiffrement sont dynamiques et sont dérivées par le processus d’authentification.
Ndis802 _ 11AuthModeWPAPSK
5
La sécurité WPA à l’aide d’une clé prépartagée. L’authentification est effectuée entre le demandeur et l’authentificateur sur IEEE 802.1 X. Les clés de chiffrement sont dynamiques et sont dérivées de la clé prépartagée utilisée par le demandeur et l’authentificateur.
Ndis802 _ 11AuthModeWPANone
6
Sécurité WPA. L’authentification s’effectue à l’aide d’une clé prépartagée sans authentification IEEE 802.1 X. Les clés de chiffrement sont statiques et sont dérivées de la clé prépartagée. Ce mode s’applique uniquement aux types de réseau ad hoc.
Ndis802 _ 11AuthModeWPA2
7
Sécurité WPA2. L’authentification est effectuée entre le demandeur, l’authentificateur et le serveur d’authentification sur IEEE 802.1 X. Les clés de chiffrement sont dynamiques et sont dérivées par le processus d’authentification.
Ndis802 _ 11AuthModeWPA2PSK
8
Spécifie la sécurité WPA2. L’authentification est effectuée entre le demandeur et l’authentificateur sur IEEE 802 1X. Les clés de chiffrement sont dynamiques et sont dérivées de la clé prépartagée utilisée par le demandeur et l’authentificateur.
Ndis802 _ 11AuthModeMax
9
Valeur maximale possible pour la valeur d’énumération du _ _ _ _ mode d’authentification NDIS 802 11 . Il ne s’agit pas d’une valeur légale pour le mode d’authentification.

nWepStatus

Mode de chiffrement actuel 802,11 défini sur l’interface.

dwCtlFlags

Valeur de masque de masque des indicateurs de contrôle qui indiquent la manière dont WZCSVC fonctionne sur l’interface.

Le tableau suivant indique les valeurs de bit possibles.

Valeur Signification
INTFCTL _ 0x0007 _ masque de cm
Masque de masque pour le mode de filtre réseau. INTFCTL _ cm _ Mask & dwCtlFlags génère une valeur de type NDIS _ 802 _ 11 _ _ infrastructure réseau. La valeur obtenue indique si WZCSVC se connecte uniquement aux réseaux d’infrastructure, aux réseaux ad hoc ou aux deux types de réseaux.
INTFCTL _ ACTIVÉ
0x8000
Indique si WZCSVC doit configurer l’interface.
INTFCTL _
0X4000
de secours
Si un réseau préféré n’est pas disponible, cette valeur indique si la configuration de la carte réseau doit être automatiquement configurée pour s’associer à un réseau disponible.
INTFCTL _ OIDSSUPP
0x2000
Indique si le pilote de carte réseau prend en charge tous les 802,11 OID requis par WZCSVC pour fonctionner.
INTFCTL _ volatile
0x1000
Indique si les paramètres de service de cette interface doivent être conservés dans le registre.
Si cette valeur est définie, ces paramètres sont volatiles et ne doivent pas être conservés dans le registre.
_ Stratégie INTFCTL
0x0800
Indique si les paramètres de service pour cette interface font l’objet d’un push par une stratégie de groupe.
Si cette valeur est définie, les paramètres du service sont envoyés à l’ordinateur local par la stratégie de groupe.
INTFCTL _ 8021XSUPP
0x1000
Indique si la prise en charge de 802.1 X est activée.

dwDynFlags

Masque de bits des indicateurs dynamiques qui contrôlent le comportement dynamique (non persistant et non statique) sur l’interface.

Ces bits sont utiles pour déclencher des modifications dynamiques et temporaires dans la façon dont le WZCSVC agit sur l’interface. Aucun de ces bits n’étant conservé dans le registre, les paramètres ne survivront pas au redémarrage du système ou à la désactivation de l’appareil et à l’activation de la séquence.

Le tableau suivant indique les valeurs de bit possibles.

Valeur Signification
INTFDYN _ Noscan
0x00000001
Indique que le WZCSVC ne doit pas demander que l’interface exécute une analyse active, mais utilise à la place les valeurs mises en cache dans le pilote de carte réseau.

dwCapabilities

Spécifie les fonctionnalités du pilote.

Valeur Signification
INTFCAP _ 0x000000FF _ _ masque de CHIFFREment Max
Les bits d’ordre inférieur de ce membre sont utilisés pour indiquer le chiffrement maximal pris en charge. les valeurs possibles sont certaines des valeurs d’énumération définies dans la structure d' _ état NDIS 802 _ 11 _ WEP _ dans le fichier d’en-tête NtDDNdis. h inclus dans le SDK Windows.
La _ valeur Ndis802 11Encryption1Enabled (2) indique que le chiffrement WEP est pris en charge. TKIP et AES ne sont pas pris en charge, et une clé de transmission peut être ou non disponible.
La _ valeur Ndis802 11Encryption2Enabled (9) indique que le protocole TKIP et le chiffrement WEP sont pris en charge. AES n’est pas pris en charge et une clé de transmission est disponible.
La _ valeur de 11Encryption3Enabled Ndis802 (11) indique que AES, TKIP et WEP sont pris en charge, et une clé de transmission est disponible.
Le Ndis802 _ 11EncryptionNotSupported (8) indique que la clé WEP n’est pas prise en charge.
INTFCAP _
0x00000100
SSN
Indique la prise en charge d’un réseau sécurisé simple (SSN) qui est un sous-ensemble de 802.11 i.
SSN modifie régulièrement la clé de chiffrement, au lieu de la norme WEP (Wired Equivalent Privacy), qui utilise une clé statique. Pour que SSN fonctionne, le chiffrement maximal pris en charge doit être au moins TKIP. Le numéro de sécurité sociale a été développé par un consortium de fournisseurs dans 2002 en tant qu’approche temporaire pour améliorer la sécurité des réseaux locaux sans fil pendant la réalisation de la norme IEEE 802.11 i.
INTFCAP _ 80211I
0x00000200
Indique la prise en charge de la norme IEEE 802.11 i.

rdNicCapabilities

Ensemble de fonctionnalités pour 802.11 i.

La fonction WZCQueryInterface retourne les données rdNicCapabilities quand elles sont appelées avec l’indicateur de _ fonctionnalités INTF passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre pData de la structure de _ données brutes contient une structure de _ _ capacité INTF 80211 .

rdSSID

Données binaires contenant le SSID 802,11 actuellement configuré sur l’interface.

La fonction WZCQueryInterface retourne les données rdSSID quand elles sont appelées avec l’indicateur _ SSID INTF passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure de _ données brutes contient le membre SsidLength d’une structure de _ SSID NDIS 802 _ _ 11 et le membre pData de la structure de _ données brutes contient le membre SSID d’une structure NDIS _ 802 _ 11 _ SSID .

La structure du _ _ _ SSID NDIS 802 11 est définie dans le fichier d’en-tête Ntddndis. h .

rdBSSID

Données binaires contenant l' 802,11 BSSID configuré sur l’interface.

La fonction WZCQueryInterface retourne les données rdBSSID quand elles sont appelées avec l’indicateur INTF _ BSSID passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure de _ données brutes contient la taille d’une structure d' _ _ _ _ adresse Mac NDIS 802 11 et le membre pData de la structure de _ données brutes contient la structure d' _ _ _ _ adresse Mac NDIS 802 11 .

La structure d' _ _ _ _ adresse Mac NDIS 802 11 est définie dans le fichier d’en-tête Ntddndis. h .

rdBSSIDList

Données binaires qui contiennent la liste des BSSIDs qui ont été récupérées pour la dernière fois par WZCSVC.

La fonction WZCQueryInterface retourne les données rdBSSIDList quand elles sont appelées avec l’indicateur INTF _ BSSIDLIST passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure de _ données brutes contient la longueur de la mémoire tampon avec les données retournées et le membre PData de la structure de _ données brutes contient la structure de liste de _ configuration WZC 802 _ 11 _ _ .

rdStSSIDList

Données binaires qui contiennent la liste des réseaux préférés configurés pour cette interface.

La fonction WZCQueryInterface retourne les données rdStSSIDList quand elles sont appelées avec l’indicateur INTF _ PREFLIST passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure de _ données brutes contient la longueur de la mémoire tampon avec les données retournées et le membre PData de la structure de _ données brutes contient la structure de liste de _ configuration WZC 802 _ 11 _ _ .

Si l’un des réseaux préférés est actuellement connecté, le jeu de bits WZCCTL _ Media _ Connected (0x0400) est défini pour le membre dwCtlFlags de la structure de _ _ configuration WLAN WZC pour le réseau.

rdCtrlData

Données binaires utilisées avec d’autres indicateurs de contrôle lors de la définition de paramètres supplémentaires sur l’interface.

Notes

La structure d' _ entrée INTF est utilisée par les fonctions WZCQueryInterface et WZCRefreshInterface .

La structure des _ données brutes est définie comme suit :

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

Le membre pData pointe vers les données binaires. DwDataLen indique le nombre d’octets pointés par pData.

Notes

le fichier d’en-tête Wzcsapi. h n’est pas disponible dans le SDK Windows.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows XP avec les [ applications de bureau SP2 uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
Fin de la prise en charge des clients
Windows XP avec SP3
Fin de la prise en charge des serveurs
Windows Server 2003
En-tête
Wzcsapi. h

Voir aussi

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface