Partager via

INTF_ENTRY structure

  • Article

[INTF_ENTRY n’est plus pris en charge à partir de Windows Vista et Windows Server 2008. Utilisez plutôt l’API Wifi native, qui fournit 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-xxxxxxxxxxxxxx} ».

wszDescr

Pointeur vers une chaîne qui contient la description de l’interface récupérée par le service WZCSVC (Wireless Zero Configuration Service).

dwContext

Réservé à un usage interne.

ulMediaState

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

Value Signification
MEDIA_STATE_CONNECTED
1
 Le média est connecté.
MEDIA_STATE_DISCONNECTED
0
 Le média est déconnecté.
MEDIA_STATE_UNKNOWN
-1
 L’état du média est inconnu.

 

ulMediaType

Types de média NDIS que la carte réseau utilise actuellement. Lorsqu’elle est interrogée, 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. Lorsqu’il est interrogé, la valeur de ce membre est NdisPhysicalMediumWirelessLan , comme défini dans le fichier d’en-tête Ndispnp.h .

nInfraMode

Le mode d’infrastructure 802.11 actuel défini sur l’interface.

nAuthMode

Le mode d’authentification 802.11 actuel défini sur l’interface.

Le tableau suivant montre les valeurs possibles pour le paramètre en fonction de l’énumération NDIS_802_11_AUTHENTICATION_MODE définie dans le fichier d’en-tête NtDDNdis.h .

Valeur Signification
Ndis802_11AuthModeOpen
1
 IEEE 802.11 Authentification open system.
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. Lors de l’utilisation du mode de basculement automatique, l’interface réseau sans fil carte tente d’abord le mode d’authentification partagée. Si le mode partagé échoue, la carte réseau tente d’utiliser le mode d’authentification ouvert.
Ndis802_11AuthModeWPA
4
 Sécurité de l’accès protégé sans fil (WPA). L’authentification est effectuée entre le demandeur, l’authentificateur et le serveur d’authentification sur IEEE 802.1X. Les clés de chiffrement sont dynamiques et sont dérivées par le processus d’authentification.
Ndis802_11AuthModeWPAPSK
5
 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.1X. Les clés de chiffrement sont dynamiques et sont dérivées par le biais de la clé prépartagée utilisée par le demandeur et l’authentificateur.
Ndis802_11AuthModeWPANone
6
 Sécurité WPA. L’authentification est effectuée à l’aide d’une clé prépartagée sans authentification IEEE 802.1X. Les clés de chiffrement sont statiques et sont dérivées par le biais 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.1X. 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 par le biais 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 NDIS_802_11_AUTHENTICATION_MODE . Il ne s’agit pas d’une valeur légale pour le mode d’authentification.

 

nWepStatus

Le mode de chiffrement 802.11 actuel défini sur l’interface.

dwCtlFlags

Valeur de masque de bits des indicateurs de contrôle qui indiquent le fonctionnement de WZCSVC sur l’interface.

Le tableau suivant présente les valeurs de bits possibles.

Valeur Signification
INTFCTL_CM_MASK
0x0007
 Masque de bits pour le mode de filtre réseau. & INTFCTL_CM_MASK dwCtlFlags aboutissent à une valeur de type NDIS_802_11_NETWORK_INFRASTRUCTURE. La valeur résultante indique si WZCSVC se connecte uniquement aux réseaux d’infrastructure, aux réseaux ad hoc ou aux deux types de réseaux.
INTFCTL_ENABLED
0x8000
 Indique si WZCSVC doit configurer l’interface.
INTFCTL_FALLBACK
0x4000
 Si un réseau préféré n’est pas disponible, cette valeur indique si WZCSVC doit configurer automatiquement la carte réseau à associer à n’importe quel réseau disponible.
INTFCTL_OIDSSUPP
0x2000
 Indique si le pilote de carte réseau prend en charge tous les OID 802.11 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.
INTFCTL_POLICY
0x0800
 Indique si les paramètres de service pour cette interface sont envoyés par une stratégie de groupe.
Si cette valeur est définie, les paramètres de service sont envoyés à l’ordinateur local par stratégie de groupe.
INTFCTL_8021XSUPP
0x1000
 Indique si la prise en charge de 802.1X est activée.

 

dwDynFlags

Masque de bits d’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 WZCSVC agit sur l’interface. Aucun de ces bits n’étant conservé dans le Registre, les paramètres ne survivront pas à un redémarrage du système ou à une séquence de désactivation et d’activation de l’appareil.

Le tableau suivant présente les valeurs de bits possibles.

Valeur Signification
INTFDYN_NOSCAN
0x00000001
 Indique que WZCSVC ne doit pas demander à l’interface d’effectuer une analyse active, mais plutôt utiliser les valeurs mises en cache dans le pilote de carte réseau.

 

dwCapabilities

Spécifie les fonctionnalités du pilote.

Valeur Signification
INTFCAP_MAX_CIPHER_MASK
0x000000ff
 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 NDIS_802_11_WEP_STATUS dans le fichier d’en-tête NtDDNdis.h inclus dans le Kit de développement logiciel (SDK) Windows.
La valeur Ndis802_11Encryption1Enabled (2) indique que WEP est pris en charge. TKIP et AES ne sont pas pris en charge, et une clé de transmission peut ou non être disponible.
La valeur Ndis802_11Encryption2Enabled (9) indique que TKIP et WEP sont pris en charge. AES n’est pas pris en charge et une clé de transmission est disponible.
La valeur Ndis802_11Encryption3Enabled (11) indique qu’AES, TKIP et WEP sont pris en charge et qu’une clé de transmission est disponible.
Le Ndis802_11EncryptionNotSupported (8) indique que la clé WEP n’est pas prise en charge.
INTFCAP_SSN
0x00000100
 Indique la prise en charge du réseau sécurisé simple (SSN), qui est un sous-ensemble de 802.11i.
SSN modifie régulièrement la clé de chiffrement, par opposition à la norme WEP (Wired Equivalent Privacy), qui utilise une clé statique. Pour que le SSN fonctionne, le chiffrement maximal pris en charge doit être au moins TKIP. SSN a été développé par un consortium de fournisseurs en 2002 en tant qu’approche intermédiaire pour améliorer la sécurité réseau sans fil pendant que la norme IEEE 802.11i était en cours d’achèvement.
INTFCAP_80211I
0x00000200
 Indique la prise en charge de la norme IEEE 802.11i.

 

rdNicCapabilities

Ensemble de fonctionnalités pour 802.11i.

La fonction WZCQueryInterface retourne des données rdNicCapabilities lorsqu’elle est appelée avec l’indicateur INTF_CAPABILITIES passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre pData de la structure RAW_DATA contient une structure INTF_80211_CAPABILITY .

rdSSID

Données binaires contenant le SSID 802.11 actuellement configuré sur l’interface.

La fonction WZCQueryInterface retourne des données rdSSID lorsqu’elle est appelée avec l’indicateur INTF_SSID passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure RAW_DATA contient le membre SsidLength d’une structure NDIS_802_11_SSID et le membre pData de la structure RAW_DATA contient le membre Ssid d’une structure NDIS_802_11_SSID .

La structure NDIS_802_11_SSID est définie dans le fichier d’en-tête Ntddndis.h .

rdBSSID

Données binaires contenant le BSSID 802.11 configuré sur l’interface.

La fonction WZCQueryInterface retourne des données rdBSSID lorsqu’elle est appelée avec l’indicateur INTF_BSSID passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure RAW_DATA contient la taille d’une structure NDIS_802_11_MAC_ADDRESS et le membre pData de la structure RAW_DATA contient la structure NDIS_802_11_MAC_ADDRESS .

La structure NDIS_802_11_MAC_ADDRESS est définie dans le fichier d’en-tête Ntddndis.h .

rdBSSIDList

Données binaires qui contiennent la liste des BSSID récupérés pour la dernière fois par WZCSVC.

La fonction WZCQueryInterface retourne des données rdBSSIDList lorsqu’elle est appelée avec l’indicateur INTF_BSSIDLIST passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure RAW_DATA contient la longueur de la mémoire tampon avec les données retournées et le membre pData de la structure RAW_DATA contient la structure WZC_802_11_CONFIG_LIST .

rdStSSIDList

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

La fonction WZCQueryInterface retourne des données rdStSSIDList lorsqu’elle est appelée avec l’indicateur INTF_PREFLIST passé dans le paramètre dwInflags . Si l’appel de fonction réussit, le membre dwDataLen de la structure RAW_DATA contient la longueur de la mémoire tampon avec les données retournées et le membre pData de la structure RAW_DATA contient la structure WZC_802_11_CONFIG_LIST .

Si l’un des réseaux préférés est actuellement connecté, le membre dwCtlFlags de la structure WZC_WLAN_CONFIG du réseau aura le bit WZCCTL_MEDIA_CONNECTED (0x0400).

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 INTF_ENTRY est utilisée par les fonctions WZCQueryInterface et WZCRefreshInterface .

La structure RAW_DATA est définie comme suit :

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

Le membre pData pointe vers des 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 SP2 [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 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