É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
-
Élément parent immédiat possible dans l’instance de schéma