Partager via

énumération WCN_ATTRIBUTE_TYPE (wcntypes.h)

  • Article

L’énumération WCN_ATTRIBUTE_TYPE définit les types de mémoire tampons d’attributs définis pour Wi-Fi installation protégée. La taille globale occupée par chaque mémoire tampon d’attribut comprend 4 octets supplémentaires (2 octets d’ID, 2 octets de longueur).

Syntax

typedef enum tagWCN_ATTRIBUTE_TYPE {
  WCN_TYPE_AP_CHANNEL = 0,
  WCN_TYPE_ASSOCIATION_STATE,
  WCN_TYPE_AUTHENTICATION_TYPE,
  WCN_TYPE_AUTHENTICATION_TYPE_FLAGS,
  WCN_TYPE_AUTHENTICATOR,
  WCN_TYPE_CONFIG_METHODS,
  WCN_TYPE_CONFIGURATION_ERROR,
  WCN_TYPE_CONFIRMATION_URL4,
  WCN_TYPE_CONFIRMATION_URL6,
  WCN_TYPE_CONNECTION_TYPE,
  WCN_TYPE_CONNECTION_TYPE_FLAGS,
  WCN_TYPE_CREDENTIAL,
  WCN_TYPE_DEVICE_NAME,
  WCN_TYPE_DEVICE_PASSWORD_ID,
  WCN_TYPE_E_HASH1,
  WCN_TYPE_E_HASH2,
  WCN_TYPE_E_SNONCE1,
  WCN_TYPE_E_SNONCE2,
  WCN_TYPE_ENCRYPTED_SETTINGS,
  WCN_TYPE_ENCRYPTION_TYPE,
  WCN_TYPE_ENCRYPTION_TYPE_FLAGS,
  WCN_TYPE_ENROLLEE_NONCE,
  WCN_TYPE_FEATURE_ID,
  WCN_TYPE_IDENTITY,
  WCN_TYPE_IDENTITY_PROOF,
  WCN_TYPE_KEY_WRAP_AUTHENTICATOR,
  WCN_TYPE_KEY_IDENTIFIER,
  WCN_TYPE_MAC_ADDRESS,
  WCN_TYPE_MANUFACTURER,
  WCN_TYPE_MESSAGE_TYPE,
  WCN_TYPE_MODEL_NAME,
  WCN_TYPE_MODEL_NUMBER,
  WCN_TYPE_NETWORK_INDEX,
  WCN_TYPE_NETWORK_KEY,
  WCN_TYPE_NETWORK_KEY_INDEX,
  WCN_TYPE_NEW_DEVICE_NAME,
  WCN_TYPE_NEW_PASSWORD,
  WCN_TYPE_OOB_DEVICE_PASSWORD,
  WCN_TYPE_OS_VERSION,
  WCN_TYPE_POWER_LEVEL,
  WCN_TYPE_PSK_CURRENT,
  WCN_TYPE_PSK_MAX,
  WCN_TYPE_PUBLIC_KEY,
  WCN_TYPE_RADIO_ENABLED,
  WCN_TYPE_REBOOT,
  WCN_TYPE_REGISTRAR_CURRENT,
  WCN_TYPE_REGISTRAR_ESTABLISHED,
  WCN_TYPE_REGISTRAR_LIST,
  WCN_TYPE_REGISTRAR_MAX,
  WCN_TYPE_REGISTRAR_NONCE,
  WCN_TYPE_REQUEST_TYPE,
  WCN_TYPE_RESPONSE_TYPE,
  WCN_TYPE_RF_BANDS,
  WCN_TYPE_R_HASH1,
  WCN_TYPE_R_HASH2,
  WCN_TYPE_R_SNONCE1,
  WCN_TYPE_R_SNONCE2,
  WCN_TYPE_SELECTED_REGISTRAR,
  WCN_TYPE_SERIAL_NUMBER,
  WCN_TYPE_WI_FI_PROTECTED_SETUP_STATE,
  WCN_TYPE_SSID,
  WCN_TYPE_TOTAL_NETWORKS,
  WCN_TYPE_UUID_E,
  WCN_TYPE_UUID_R,
  WCN_TYPE_VENDOR_EXTENSION,
  WCN_TYPE_VERSION,
  WCN_TYPE_X_509_CERTIFICATE_REQUEST,
  WCN_TYPE_X_509_CERTIFICATE,
  WCN_TYPE_EAP_IDENTITY,
  WCN_TYPE_MESSAGE_COUNTER,
  WCN_TYPE_PUBLIC_KEY_HASH,
  WCN_TYPE_REKEY_KEY,
  WCN_TYPE_KEY_LIFETIME,
  WCN_TYPE_PERMITTED_CONFIG_METHODS,
  WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODS,
  WCN_TYPE_PRIMARY_DEVICE_TYPE,
  WCN_TYPE_SECONDARY_DEVICE_TYPE_LIST,
  WCN_TYPE_PORTABLE_DEVICE,
  WCN_TYPE_AP_SETUP_LOCKED,
  WCN_TYPE_APPLICATION_EXTENSION,
  WCN_TYPE_EAP_TYPE,
  WCN_TYPE_INITIALIZATION_VECTOR,
  WCN_TYPE_KEY_PROVIDED_AUTOMATICALLY,
  WCN_TYPE_802_1X_ENABLED,
  WCN_TYPE_APPSESSIONKEY,
  WCN_TYPE_WEPTRANSMITKEY,
  WCN_TYPE_UUID,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY,
  WCN_TYPE_CURRENT_SSID,
  WCN_TYPE_BSSID,
  WCN_TYPE_DOT11_MAC_ADDRESS,
  WCN_TYPE_AUTHORIZED_MACS,
  WCN_TYPE_NETWORK_KEY_SHAREABLE,
  WCN_TYPE_REQUEST_TO_ENROLL,
  WCN_TYPE_REQUESTED_DEVICE_TYPE,
  WCN_TYPE_SETTINGS_DELAY_TIME,
  WCN_TYPE_VERSION2,
  WCN_TYPE_VENDOR_EXTENSION_WFA,
  WCN_NUM_ATTRIBUTE_TYPES
} WCN_ATTRIBUTE_TYPE;

Constantes

 
WCN_TYPE_AP_CHANNEL
Valeur : 0
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur contenant des données qui spécifie le canal 802.11 hébergé par le point d’accès.
WCN_TYPE_ASSOCIATION_STATE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur contenant l’état d’association ou les informations de configuration définies par WCN_VALUE_TYPE_ASSOCIATION_STATE.
WCN_TYPE_AUTHENTICATION_TYPE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur contenant un type d’authentification défini par WCN_VALUE_TYPE_AUTHENTICATION_TYPE.
WCN_TYPE_AUTHENTICATION_TYPE_FLAGS
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur contenant des données qui spécifie les fonctionnalités d’authentification réseau de l’inscrit (point d’accès ou station) en fournissant un
valeur définie par WCN_VALUE_TYPE_AUTHENTICATION_TYPE.
WCN_TYPE_AUTHENTICATOR
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon contenant un hachage de données à clé.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_CONFIG_METHODS
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient des valeurs, définies par WCN_VALUE_TYPE_CONFIG_METHODS, qui spécifient les méthodes de configuration prises en charge par l’inscrit ou le bureau d’inscription. En outre, les points d’accès et les stations
qui prennent en charge l’interface de gestion UPnP doivent également prendre en charge cet attribut, qui
est utilisé pour contrôler les méthodes de configuration activées sur le point d’accès.
WCN_TYPE_CONFIGURATION_ERROR
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur, définie par WCN_VALUE_TYPE_CONFIGURATION_ERROR, qui spécifie le résultat de la tentative de configuration et d’association de l’appareil au WLAN.

Si une session de configuration échoue avec le code d’erreur WCN_E_CONNECTION_REJECTED, tout code d’erreur retourné par l’appareil distant peut être obtenu en interrogeant cet attribut. Il est important de noter que certains appareils retournent WCN_VALUE_CE_NO_ERROR même si une erreur s’est produite.
WCN_TYPE_CONFIRMATION_URL4
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon qui contient des données représentant l’URL (basée sur l’adresse IPv4) fournie par le bureau d’enregistrement au inscrit pour une utilisation dans la confirmation de publication
une fois que les paramètres ont été appliqués et que le réseau a été joint. Cette configuration
le paramètre est facultatif pour un bureau d’inscription, et il est facultatif pour le inscrit de publier sur l’URL si le bureau d’inscription
l’inclut.

Note Un inscrit ne doit pas se connecter à une URL de confirmation qui se trouve sur un autre sous-réseau.

 
WCN_TYPE_CONFIRMATION_URL6
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon qui contient des données représentant l’URL (basée sur l’adresse IPv6) fournie par le bureau d’enregistrement au inscrit pour l’utiliser lors de la publication d’une confirmation
une fois que les paramètres ont été appliqués et que le réseau a été joint. Cette configuration
le paramètre est facultatif pour un bureau d’inscription et il est facultatif pour que l’inscrit publie sur l’URL si le bureau d’inscription
l’inclut.

Note L’inscrit ne doit pas se connecter à une URL de confirmation qui se trouve sur un autre sous-réseau.

 
WCN_TYPE_CONNECTION_TYPE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient une valeur, définie par WCN_VALUE_TYPE_CONNECTION_TYPE, qui spécifie la fonctionnalité de connexion de l’inscrit.
WCN_TYPE_CONNECTION_TYPE_FLAGS
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient une valeur, définie par WCN_VALUE_TYPE_CONNECTION_TYPE, qui spécifie la fonctionnalité de connexion de l’inscrit.
WCN_TYPE_CREDENTIAL
Cette valeur d’attribut composée indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute contient une seule information d’identification WLAN. Il peut y avoir plusieurs attributs d’informations d’identification pour chaque clé réseau, ou plusieurs
Clés réseau dans un seul attribut Credential, qui est accompli en répétant l’index de clé réseau et les attributs qui
suivez-le. En général, plusieurs
les clés d’une seule information d’identification pour un seul SSID doivent être utilisées, et plusieurs attributs d’informations d’identification pour
des SSID distincts doivent être utilisés. Les attributs suivants sont contenus dans chaque instance d’informations d’identification :


  • WCN_TYPE_AUTHENTICATION_TYPE

  • WCN_TYPE_ENCRYPTION_TYPE

  • WCN_TYPE_SSID

  • WCN_TYPE_NETWORK_INDEX


Si une application a l’intention d’utiliser les informations d’identification réseau avec l’API WLAN, elle doit utiliser IWCNDevice ::GetNetworkProfile pour obtenir directement un profil réseau XML compatible.
WCN_TYPE_DEVICE_NAME
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon qui contient une description conviviale de l’appareil encodé en UTF-8. En règle générale, le composant
serait un identificateur unique qui décrit le produit d’une manière reconnaissable par l’utilisateur.
WCN_TYPE_DEVICE_PASSWORD_ID
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient une valeur, définie par WCN VALUE TYPE DEVICE_PASSWORD_ID, utilisée pour identifier un mot de passe d’appareil.
WCN_TYPE_E_HASH1
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute contient le hachage HMAC-SHA-256 de la première moitié du mot de passe de l’appareil et le premier secret de l’inscrit
nonce.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_E_HASH2
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute contient le hachage HMAC-SHA-256 de la deuxième moitié du mot de passe de l’appareil, et la seconde de l’inscrit
secret nonce.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_E_SNONCE1
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient le premier nonce utilisé par l’inscrit avec la première moitié du mot de passe de l’appareil.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_E_SNONCE2
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient le deuxième nonce utilisé par l’inscrit avec la deuxième moitié du mot de passe de l’appareil.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_ENCRYPTED_SETTINGS
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute contient un vecteur d’initialisation (IV) suivi d’un set
des attributs TLV de configuration protégée Wi-Fi chiffrés. Le dernier attribut de l’ensemble chiffré est un wrapper de clé
Authentificateur calculé selon la procédure décrite dans la section 6.5.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_ENCRYPTION_TYPE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient une valeur, définie par WCN_VALUE_TYPE_ENCRYPTION_TYPE, pour l’inscrit (AP ou
station) à utiliser.
WCN_TYPE_ENCRYPTION_TYPE_FLAGS
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient une valeur, définie par WCN_VALUE_TYPE_ENCRYPTION_TYPE, pour l’inscrit (AP ou
station) à utiliser.
WCN_TYPE_ENROLLEE_NONCE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient une valeur binaire générée de manière aléatoire qui est créée par l’inscrit pour
opérations d’installation.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_FEATURE_ID
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute contient des données qui indiquent une build de fonctionnalité particulière pour un système d’exploitation s’exécutant sur l’appareil. Le bit le plus significatif de l’entier de 4 octets est réservé et toujours défini sur un.
WCN_TYPE_IDENTITY
Réservé. Ne pas utiliser.
WCN_TYPE_IDENTITY_PROOF
Réservé. Ne pas utiliser.
WCN_TYPE_KEY_WRAP_AUTHENTICATOR
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon de 8 octets contenant les 64 premiers bits du HMAC-SHA-256 calculés sur les données à chiffrer
avec l’algorithme d’habillage de clé. Il est ajouté à la fin de configData avant le chiffrement.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_KEY_IDENTIFIER
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetAttribute est une mémoire tampon de 16 octets contenant un identificateur de clé de 128 bits. Si cet attribut précède immédiatement une donnée chiffrée
ou l’attribut Authenticator, puis la clé correspondant à l’identificateur 128 bits doit être utilisée pour déchiffrer
ou vérifiez le champ Données.
WCN_TYPE_MAC_ADDRESS
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute est une mémoire tampon de 6 octets contenant la valeur de 48 bits de l’adresse MAC. For
exemple : 0x00 0x07 0xE9 0x4C 0xA8 0x1C.

Cette adresse est fournie par l’appareil distant. Certains points d’accès fournissent l’adresse MAC de leur interface Ethernet, auquel cas l’adresse ne peut pas être utilisée pour localiser la radio sans fil de l’AP. Si une application doit localiser la radio d’un AP, l’application doit interroger l’attribut WCN_TYPE_BSSID, qui est rempli par Windows et est généralement plus fiable.
WCN_TYPE_MANUFACTURER
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute est une mémoire tampon contenant une chaîne qui identifie le fabricant de l’appareil.
En règle générale, ce champ doit permettre à un utilisateur d’effectuer une association avec un appareil avec l’étiquetage sur le
appareil.
WCN_TYPE_MESSAGE_TYPE
Réservé. Ne pas utiliser.
WCN_TYPE_MODEL_NAME
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon qui identifie le modèle de l’appareil. En règle générale, ce champ
doit permettre à un utilisateur de créer une association d’un appareil avec l’étiquetage sur l’appareil.
WCN_TYPE_MODEL_NUMBER
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une chaîne contenant des données descriptives supplémentaires associées à l’appareil.
WCN_TYPE_NETWORK_INDEX
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 1 octet utilisée pour obtenir et définir les paramètres réseau pour les appareils qui hébergent plusieurs réseaux. The
la valeur par défaut est « 1 », qui fait référence au réseau WLAN principal sur l’appareil.
WCN_TYPE_NETWORK_KEY
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon contenant la clé de chiffrement sans fil à utiliser par l’inscrit. Notez qu’il est recommandé que les applications implémentent IWCNDevice ::GetNetworkProfile pour obtenir les paramètres réseau dans un format pratique prêt à être utilisé avec les API de gestion des profils et des connexions WLAN.
WCN_TYPE_NETWORK_KEY_INDEX
Réservé. Ne pas utiliser.
WCN_TYPE_NEW_DEVICE_NAME
Réservé. Ne pas utiliser.
WCN_TYPE_NEW_PASSWORD
Réservé. Ne pas utiliser.
WCN_TYPE_OOB_DEVICE_PASSWORD
Réservé. Ne pas utiliser.
WCN_TYPE_OS_VERSION
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 4 octets qui contient la version du système d’exploitation exécutée sur l’appareil. Le bit le plus significatif de ce champ de 4 octets est réservé et toujours défini sur un.
WCN_TYPE_POWER_LEVEL
Réservé. Ne pas utiliser.
WCN_TYPE_PSK_CURRENT
Réservé. Ne pas utiliser.
WCN_TYPE_PSK_MAX
Réservé. Ne pas utiliser.
WCN_TYPE_PUBLIC_KEY
Réservé. Ne pas utiliser. Nous vous recommandons d’envoyer un secret partagé par le biais d’une extension de fournisseur ou de trouver un autre moyen d’effectuer le chiffrement.
WCN_TYPE_RADIO_ENABLED
Réservé. Ne pas utiliser.
WCN_TYPE_REBOOT
Réservé. Ne pas utiliser.
WCN_TYPE_REGISTRAR_CURRENT
Réservé. Ne pas utiliser.
WCN_TYPE_REGISTRAR_ESTABLISHED
Réservé. Ne pas utiliser.
WCN_TYPE_REGISTRAR_LIST
Réservé. Ne pas utiliser.
WCN_TYPE_REGISTRAR_MAX
Réservé. Ne pas utiliser.
WCN_TYPE_REGISTRAR_NONCE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 16 octets contenant une valeur binaire générée de manière aléatoire créée par le bureau d’inscription pour
Configuration.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_REQUEST_TYPE
Réservé. Ne pas utiliser.
WCN_TYPE_RESPONSE_TYPE
Réservé. Ne pas utiliser.
WCN_TYPE_RF_BANDS
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur entière, définie par WCN_VALUE_TYPE_RF_BANDS, qui indique la bande RF utilisée lors de l’échange de messages, ce qui autorise la fin
points et proxys pour communiquer via une interface radio cohérente. Il peut également être utilisé en tant que
dans un WCN_TYPE_CREDENTIAL ou un WCN_TYPE_ENCRYPTED_SETTINGS pour indiquer un groupe spécifique de bandes RF auxquelles un
le paramètre s’applique.
WCN_TYPE_R_HASH1
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon de 32 octets qui contient le hachage HMAC-SHA-256 de la première moitié du mot de passe de l’appareil et le premier secret du bureau d’enregistrement
nonce.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_R_HASH2
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon de 32 octets contenant le hachage HMAC-SHA-256 de la deuxième moitié du mot de passe de l’appareil et la seconde du bureau d’enregistrement
secret nonce.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_R_SNONCE1
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 16 octets contenant le premier nonce utilisé par le bureau d’inscription avec la première moitié du mot de passe de l’appareil.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_R_SNONCE2
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 16 octets contenant le deuxième nonce utilisé par le bureau d’inscription avec la deuxième moitié du mot de passe de l’appareil.

Note La sécurité est gérée en toute transparence par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_SELECTED_REGISTRAR
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur entière, définie par WCN_VALUE_TYPE_BOOLEAN, qui indique si un serveur d’inscription a été sélectionné par un utilisateur et qu’un inscrit peut continuer avec
configuration d’un port de données non contrôlé 802.1X avec le bureau d’inscription.
WCN_TYPE_SERIAL_NUMBER
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une chaîne contenant le numéro de série de l’inscrit.

Note Tous les appareils ne fournissent pas de numéro de série. Certains appareils retournent une chaîne de caractères non numériques et, par conséquent, il n’est pas toujours possible de convertir cette valeur en nombre.

 
WCN_TYPE_WI_FI_PROTECTED_SETUP_STATE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur entière, définie par WCN_VALUE_TYPE_WI_FI_PROTECTED_SETUP, qui indique si un appareil est configuré.
WCN_TYPE_SSID
Cette valeur d’attribut indique que le paramètre pbData de la méthode IWCNDevice ::GetAttribute est une mémoire tampon, d’une taille maximale de 32 octets, contenant l’identificateur de jeu de services (SSID) ou le nom du réseau.

Au lieu d’interroger cet attribut, il est recommandé que les applications implémentent IWCNDevice ::GetNetworkProfile pour récupérer les paramètres réseau dans un format pratique prêt à être utilisé avec les API de gestion des profils et des connexions WLAN.
WCN_TYPE_TOTAL_NETWORKS
Réservé. Ne pas utiliser.
WCN_TYPE_UUID_E
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 16 octets contenant l’identificateur unique universel (UUID) généré par l’inscrit. Informatique
identifie de manière unique un appareil opérationnel et doit survivre aux redémarrages et aux réinitialisations. L’UUID est fourni dans
format binaire. Si l’appareil prend également en charge UPnP, l’UUID correspond à l’UUID UPnP.

Au lieu d’interroger cet attribut, les applications doivent plutôt interroger l’attribut WCN_TYPE_UUID, car il est disponible pour les inscrits et les bureaux d’enregistrement. WCN_TYPE_UUID_E_ est disponible uniquement pour les appareils qui agissent en tant que personnes inscrites.
WCN_TYPE_UUID_R
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute est une mémoire tampon de 16 octets contenant l’élément UUID (Universally Unique Identifier) généré par le bureau d’inscription. Informatique
identifie de manière unique un appareil opérationnel et doit survivre aux redémarrages et aux réinitialisations. L’UUID est fourni dans
format binaire. Si l’appareil prend également en charge UPnP, l’UUID correspond à l’UUID UPnP.

Au lieu d’interroger cet attribut, les applications doivent plutôt interroger l’attribut WCN_TYPE_UUID, car il est disponible pour les inscrits et les bureaux d’enregistrement.
WCN_TYPE_VENDOR_EXTENSION
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetAttribute est une mémoire tampon, d’une taille maximale de 1 024 octets, qui permet d’utiliser des extensions de fournisseur dans l’infrastructure TLV d’installation protégée Wi-Fi. Fournisseur
La figure d’extension illustre l’implémentation des extensions du fournisseur. L’ID du fournisseur est le code d’entreprise privé de gestion de réseau SMI.

Au lieu d’interroger cette valeur, l’implémentation de l’API IWCNDevice ::GetVendorExtension est recommandée pour des raisons de commodité et de flexibilité lors de l’accès direct à l’attribut d’extension fournisseur brut.
WCN_TYPE_VERSION
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur entière qui indique la Wi-Fi version du programme d’installation protégé. Le champ d’un octet est divisé en une partie principale de quatre bits à l’aide de
les bases de données supérieures et la partie mineure quatre bits à l’aide des LSB. Par exemple, la version 3.2 serait 0x32.

Note Windows utilise automatiquement la version WPS correcte pour chaque appareil. Les applications ne sont donc pas tenues d’interroger ou de définir cette valeur.

 

Note Lors de l’utilisation de WPS 2.0, WCN_TYPE_VERSION est toujours défini sur 0x10 et WCN_TYPE_VERSION2 est utilisé à la place

 
WCN_TYPE_X_509_CERTIFICATE_REQUEST
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute est une mémoire tampon contenant une charge utile de demande de certificat X.509, comme spécifié dans RFC 2511.
WCN_TYPE_X_509_CERTIFICATE
Cette valeur d’attribut indique que le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute est une mémoire tampon contenant un certificat X.509.
WCN_TYPE_EAP_IDENTITY
Réservé. Ne pas utiliser.
WCN_TYPE_MESSAGE_COUNTER
Réservé. Ne pas utiliser.
WCN_TYPE_PUBLIC_KEY_HASH
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon de 20 octets contenant les 160 premiers bits du hachage SHA-256 d’une clé publique.

Note La sécurité est gérée de manière transparente par Windows. Par conséquent, les applications n’ont pas besoin d’interroger ou de définir cet attribut.

 
WCN_TYPE_REKEY_KEY
Réservé. Ne pas utiliser.
WCN_TYPE_KEY_LIFETIME
Réservé. Ne pas utiliser.
WCN_TYPE_PERMITTED_CONFIG_METHODS
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est un entier défini par WCN_VALUE_TYPE_CONFIG_METHODS, qui indique quelles méthodes de configuration prises en charge par l’appareil sont activées.
WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODS
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est un entier défini par WCN_VALUE_TYPE_CONFIG_METHODS, qui est utilisé dans les messages de réponse de sonde à
transmettre les méthodes de configuration prises en charge actuelles d’un bureau d’enregistrement spécifique.
WCN_TYPE_PRIMARY_DEVICE_TYPE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 8 octets contenant des valeurs, contenues dans WCN_VALUE_TYPE_PRIMARY_DEVICE_TYPE, qui indique le type principal de l’appareil. Il est recommandé que les applications interrogent plutôt les attributs WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY, WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI et WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY, car ils sont plus pratiques.
WCN_TYPE_SECONDARY_DEVICE_TYPE_LIST
Réservé. Ne pas utiliser.
WCN_TYPE_PORTABLE_DEVICE
Réservé. Ne pas utiliser.
WCN_TYPE_AP_SETUP_LOCKED
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon contenant une valeur, définie par WCN_VALUE_TYPE_BOOLEAN, qui indique si le point d’accès a entré un état dans lequel il refusera d’autoriser un bureau d’enregistrement externe
pour tenter d’exécuter le protocole d’inscription à l’aide du code PIN de l’AP (avec l’AP agissant en tant que Inscrit). Le point d’accès
doit entrer dans cet état s’il estime qu’une attaque par force brute est en cours contre le code PIN de l’AP.
Lorsque l’AP est dans cet état, il DOIT continuer à autoriser les autres inscrits à se connecter et à exécuter le
Protocole d’inscription avec tous les bureaux d’enregistrement externes ou le bureau d’enregistrement intégré de l’AP (le cas échéant). Il s’agit uniquement de l’utilisation
du code pin de l’AP pour l’ajout de bureaux d’enregistrement externes qui est désactivé dans cet état.
L’état Verrouillé du programme d’installation de l’ap peut être réinitialisé à FALSE via un appel authentifié à SetAPSettings. Aps
peut également fournir d’autres méthodes spécifiques à l’implémentation pour réinitialiser l’état Verrouillé de l’installation de l’AP.
WCN_TYPE_APPLICATION_EXTENSION
Cette valeur d’attribut indique que le paramètre pvBuffer de la méthode IWCNDevice ::GetAttribute est une mémoire tampon, d’une taille maximale de 512 octets, utilisée pour passer les paramètres d’activation des applications pendant le WSC
Échange. Il est similaire à l’attribut Vendor Extension, sauf qu’au lieu d’un préfixe d’ID fournisseur de 3 octets
dans le champ Données du fournisseur, un UUID de 16 octets (tel que défini dans RFC 4122) est utilisé. Cela fournit une quasi-totalité des
espace d’ID d’application illimité avec une structure régulière qui peut être facilement mappée à un générique
API d’extension d’application. En outre, la valeur UUID de 16 octets peut être utilisée pour dériver une application spécifique
Les AMSK comme décrit dans la section 6.3 ou passent directement toute clé nécessaire.
WCN_TYPE_EAP_TYPE
Réservé. Ne pas utiliser.
WCN_TYPE_INITIALIZATION_VECTOR
Réservé. Ne pas utiliser.
WCN_TYPE_KEY_PROVIDED_AUTOMATICALLY
Réservé. Ne pas utiliser.
WCN_TYPE_802_1X_ENABLED
Réservé. Ne pas utiliser.
WCN_TYPE_APPSESSIONKEY
Cette valeur d’attribut représente la mémoire tampon, d’une taille maximale de 128 octets, contenant des données qui indiquent un échange de clés de session spécifiques à l’application.
pour calculer les AMSK.
WCN_TYPE_WEPTRANSMITKEY
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon à 1 octet contenant des données qui identifient la valeur d’index de clé utilisée comme clé de transmission du point d’accès pour les configurations WEP.
WCN_TYPE_UUID
Cet attribut composé indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon de 16 octets qui contient des données toujours égales à l’UUID de l’appareil, que l’appareil soit inscrit ou bureau d’enregistrement. (En fait, fusionne WCN_TYPE_UUID_E et WCN_TYPE_UUID_R).
WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY
Cette valeur d’attribut indique que le paramètre puInteger de IWCNDevice ::GetIntegerAttribute est un entier qui représente la catégorie d’appareil principale d’un appareil WCN. La catégorie d’appareil principale est l’une des valeurs WCN_VALUE_TYPE_DEVICE_TYPE_CATEGORY.
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI
Cette valeur d’attribut indique que le paramètre puInteger de IWCNDevice ::GetIntegerAttribute est un entier qui représente le OUI qui définit la sous-catégorie d’appareil d’un appareil WCN. La valeur OUI la plus courante est WCN_VALUE_DT_SUBTYPE_WIFI_OUI qui indique que la sous-catégorie est définie par l’alliance Wi-Fi.
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY
Cette valeur d’attribut indique que le paramètre puInteger de IWCNDevice ::GetIntegerAttribute est un entier qui représente la sous-catégorie d’appareil d’un appareil WCN. La sous-catégorie doit être interprétée avec le OUI de WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI. Pour les appareils qui utilisent l'Wi-Fi Alliance OUI. La sous-catégorie est l’une des valeurs WCN_VALUE_TYPE_DEVICE_TYPE_SUBCATEGORY.
WCN_TYPE_CURRENT_SSID
Cette valeur d’attribut indique que le paramètre wszString de la méthode IWCNDevice ::GetStringAttribute est une mémoire tampon, d’une taille maximale de 32 octets, contenant le SSID actuel d’un point d’accès sans fil.
WCN_TYPE_BSSID
Réservé. Ne pas utiliser.
WCN_TYPE_DOT11_MAC_ADDRESS
Réservé. Ne pas utiliser.
WCN_TYPE_AUTHORIZED_MACS
. Cette valeur d’attribut indique qu’un bureau d’enregistrement fournit une liste d’adresses MAC autorisées à démarrer WSC. Le paramètre pbBuffer de la méthode IWCNDevice ::GetAttribute est une mémoire tampon de 6 à 30 octets contenant la valeur de 48 bits de chaque adresse MAC dans la liste des contrôleurs de gestion autorisés. Par exemple : 0x00 0x07 0xE9 0x4C 0xA8 0x1C.

Note Disponible uniquement dans Windows 8.

 
WCN_TYPE_NETWORK_KEY_SHAREABLE
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon d'1 octet utilisée pour obtenir et définir les paramètres réseau pour les appareils qui hébergent plusieurs réseaux. La valeur « 1 » indique que la clé réseau peut être partagée avec d’autres appareils.

Note Disponible uniquement dans Windows 8.

 
WCN_TYPE_REQUEST_TO_ENROLL
Réservé. Ne pas utiliser.
WCN_TYPE_REQUESTED_DEVICE_TYPE
Réservé. Ne pas utiliser.
WCN_TYPE_SETTINGS_DELAY_TIME
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une mémoire tampon d'1 octet indiquant la durée estimée (en secondes) nécessaire à un point d’accès pour se reconfigurer et devenir disponible, ou qu’un appareil devra appliquer des paramètres et se connecter à un réseau.

Note Disponible uniquement dans Windows 8.

 
WCN_TYPE_VERSION2
Cette valeur d’attribut indique que le paramètre puInteger de la méthode IWCNDevice ::GetIntegerAttribute est une valeur entière qui indique la Wi-Fi version du programme d’installation protégé. Le champ d’un octet est divisé en une partie principale de quatre bits à l’aide de
les bases de données supérieures et la partie mineure quatre bits à l’aide des LSB. Par exemple, la version 3.2 serait 0x32.

Note Windows utilise automatiquement la version WPS correcte pour chaque appareil. Les applications ne sont donc pas tenues d’interroger ou de définir cette valeur.

 

Note Disponible uniquement dans Windows 8.

 
WCN_TYPE_VENDOR_EXTENSION_WFA
Réservé. Ne pas utiliser.

Note Les attributs au sein de l’extension du fournisseur WFA peuvent être interrogés directement.

 
WCN_NUM_ATTRIBUTE_TYPES
Nombre d’attributs attribués.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête wcntypes.h