Élément keyMaterial (sharedKey)

L’élément keyMaterial (sharedKey) contient une clé réseau ou une phrase secrète. Si l’élément protégé a la valeur true, ce matériel de clé est chiffré ; dans le cas contraire, le matériel de clé n’est pas chiffré. Le matériel de clé chiffrée est exprimé au format hexadécimal.

<xs:element name="keyMaterial"
    type="string"
 />

L’élément est défini par l’élément sharedKey .

Notes

La plage de valeurs valides pour l’élément keyMaterial varie selon le type d’authentification et le chiffrement utilisés, comme spécifié par les éléments Authentication et Encryption . Elle varie également en fonction du type de frappe.

Le tableau suivant indique les valeurs de clés valides pour certaines paires d’authentification et de chiffrement.

valeur d’authentification valeur de chiffrement valeur de KeyType Valeurs de clés valides
ouvert ou partagé WEP networkKey Cet élément contient une clé WEP de 5 ou 13 caractères ANSI, ou de 10 ou 26 caractères hexadécimaux.
WPAPSK ou WPA2PSK TKIP ou AES passPhrase Cet élément contient une phrase secrète comprise entre 8 et 63 caractères ASCII, soit 8 à 63 caractères ANSI dans la plage de 32 à 126. Les valeurs de clé doivent respecter les exigences spécifiées par la norme 802.11 i.
WPAPSK ou WPA2PSK TKIP ou AES networkKey Cet élément contient une clé de 64 caractères hexadécimaux.

Des caractères Unicode peuvent être entrés là où les caractères ANSI ou ASCII sont spécifiés ci-dessus. Toutefois, si les caractères Unicode fournis ne peuvent pas être mappés à des caractères ANSI ou ASCII, le matériel de clé fourni est rejeté.

Le matériel de clé retourné par WlanGetProfile est toujours chiffré. En outre, si le matériel de clé non chiffré est transmis à WLanSetProfile, le matériel de clé est automatiquement chiffré avant d’être stocké dans le magasin de profils.

Windows xp avec SP3 et l’API de réseau local sans fil pour Windows XP avec SP2 : Le matériel de clé n’est jamais chiffré.

Si votre processus s’exécute dans le contexte du compte LocalSystem, vous pouvez déchiffrer le matériel de clé en appelant CryptUnprotectData.

Exemples

Pour afficher des exemples de profils qui utilisent l’élément keyMaterial , consultez exemple de profil de non-diffusion, exemple de Profil WPA-Personnelet exemple de profil WPA2-Personal.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista, Windows XP avec les [ applications de bureau SP3 uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
Composant redistribuable
API de réseau local sans fil pour Windows XP avec SP2

Voir aussi

Contexte de définition de l’élément dans le schéma

sharedKey

Élément parent immédiat possible dans l’instance de schéma

sharedKey (sécurité)