Méthode ChangePIN de la classe Win32_EncryptableVolume
La méthode ChangePIN de la classe Win32_EncryptableVolume modifie le code pin associé à un volume chiffré. Si la stratégie de groupe « Autoriser les codes pin améliorés pour le démarrage » est activée, un code confidentiel peut contenir des lettres, des symboles et des espaces en plus des chiffres.
Syntaxe
uint32 ChangePIN(
[in] string VolumeKeyProtectorID,
[in] string NewPIN
);
Paramètres
-
VolumeKeyProtectorID [in]
-
Type : chaîne
Identificateur de chaîne unique utilisé pour gérer un protecteur de clé de volume chiffré.
-
NewPIN [in]
-
Type : chaîne
Chaîne d’identification personnelle spécifiée par l’utilisateur. Cette chaîne doit se composer d’une séquence de 4 à 20 chiffres ou, si la stratégie de groupe « Autoriser les codes confidentiels améliorés pour le démarrage » est activée, de 4 à 20 lettres, symboles, espaces ou nombres.
Valeur retournée
Type : uint32
Cette méthode retourne l’un des codes suivants ou un autre code d’erreur en cas d’échec.
| Code/valeur de retour | Description |
|---|---|
|
La méthode a réussi. |
|
Un CD/DVD de démarrage se trouve sur cet ordinateur. Supprimez le CD/DVD et redémarrez l’ordinateur. |
|
Le paramètre NewPIN contient des caractères qui ne sont pas valides. Lorsque le stratégie de groupe « Autoriser les codes PIN améliorés pour le démarrage » est désactivé, seuls les nombres sont pris en charge. |
|
Le paramètre VolumeKeyProtectorID ne fait pas référence à un protecteur de clé de type « Password numérique » ou « External Key ». Utilisez la méthode ProtectKeyWithNumericalPassword ou ProtectKeyWithExternalKey pour créer un protecteur de clé du type approprié. |
|
Le volume est verrouillé. |
|
BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clés pour activer BitLocker. |
|
Le paramètre NewPIN fourni est soit plus long que 20 caractères, plus court que 4 caractères ou plus court que la longueur minimale spécifiée par stratégie de groupe. |
|
Le protecteur de clé fourni n’existe pas sur le volume. |
|
Aucun module de plateforme sécurisée (TPM) compatible n’est trouvé sur cet ordinateur. |
Notes
La méthode ChangePIN crée un module TPM et un logiciel de protection de code confidentiel en fonction des informations de protection existantes et du code confidentiel nouvellement fourni. Le nouveau protecteur aura le même GUID. La méthode ChangePIN peut également être appelée pour modifier le code pin de n’importe quel protecteur de clé qui utilise un code CONFIDENTIEL, par exemple, TPM et code confidentiel ou TPM avec code confidentiel et USB.
Les fichiers MOF (Managed Object Format) contiennent les définitions des classes WMI (Windows Management Instrumentation). Les fichiers MOF ne sont pas installés dans le cadre du Kit de développement logiciel (SDK) Windows. Ils sont installés sur le serveur lorsque vous ajoutez le rôle associé à l’aide du Gestionnaire de serveur. Pour plus d’informations sur les fichiers MOF, consultez Managed Object Format (MOF).
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 7 Entreprise, Windows 7 Édition Intégrale [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 R2 [applications de bureau uniquement] |
| Espace de noms |
Root\CIMV2\Security\MicrosoftVolumeEncryption |
| MOF |
|
Voir aussi