Delen via


Methode ProtectKeyWithNumericalPassword van de klasse Win32_EncryptableVolume

De methode ProtectKeyWithNumericalPassword van de klasse Win32_EncryptableVolume beveiligt de versleutelingssleutel van het volume met een speciaal opgemaakt wachtwoord van 48 cijfers. Dit numerieke wachtwoord kan worden gebruikt om te herstellen van de verificatiefouten van andere sleutelbeveiligingen (bijvoorbeeld TPM).

Er wordt een sleutelbeveiliging van het type Numeriek wachtwoord gemaakt voor het volume.

Gebruik de methode IsNumericalPasswordValid om de notatie van het numerieke wachtwoord te valideren.

Syntaxis

uint32 ProtectKeyWithNumericalPassword(
  [in, optional] string FriendlyName,
  [in, optional] string NumericalPassword,
  [out]          string VolumeKeyProtectorID
);

Parameterwaarden

FriendlyName [in, optioneel]

Type: tekenreeks

Een tekenreeks die een door de gebruiker toegewezen id voor deze sleutelbeveiliging opgeeft. Als deze parameter niet is opgegeven, wordt een lege waarde gebruikt.

NumericalPassword [in, optioneel]

Type: tekenreeks

Een tekenreeks die het speciaal opgemaakte numerieke wachtwoord van 48 cijfers aangeeft.

Het numerieke wachtwoord moet 48 cijfers bevatten. Deze cijfers kunnen worden onderverdeeld in 8 groepen van 6 cijfers, waarbij het laatste cijfer in elke groep een controlesomwaarde voor de groep aangeeft. Elke groep van 6 cijfers moet deelbaar zijn door 11 en moet 720885 of minder zijn. Ervan uitgaande dat een groep van zes cijfers is gelabeld als x1, x2, x3, x4, x5 en x6, wordt het controlesom x6-cijfer berekend als –x1+x2–x3+x4–x5 mod 11.

De groepen cijfers kunnen eventueel worden gescheiden door een spatie of afbreekstreepje. Daarom kunnen 'xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx' of 'xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx' ook geldige numerieke wachtwoorden bevatten.

Als er geen numeriek wachtwoord is opgegeven, wordt er een willekeurig gegenereerd. Gebruik de methode GetKeyProtectorNumericalPassword om het willekeurig gegenereerde wachtwoord op te halen.

VolumeKeyProtectorID [out]

Type: tekenreeks

Een tekenreeks die de unieke id is die is gekoppeld aan de gemaakte protector en die kan worden gebruikt om de sleutelbeveiliging te beheren.

Als het station hardwareversleuteling ondersteunt en BitLocker geen bandeigendom heeft genomen, wordt de id-tekenreeks ingesteld op BitLocker en wordt de sleutelbeveiliging naar metagegevens per band geschreven.

Retourwaarde

Type: uint32

Deze methode retourneert een van de volgende codes of een andere foutcode als deze mislukt.

Retourcode/waarde Beschrijving
S_OK
0 (0x0)
De methode is geslaagd.
E_INVALIDARG
2147942487 (0x80070057)
De parameter NumericalPassword heeft geen geldige indeling.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
Het volume is vergrendeld.
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
De parameter NumericalPassword heeft geen geldige indeling.

 

Opmerkingen

MOF-bestanden (Managed Object Format) bevatten de definities voor WMI-klassen (Windows Management Instrumentation). MOF-bestanden worden niet geïnstalleerd als onderdeel van de Windows SDK. Ze worden geïnstalleerd op de server wanneer u de bijbehorende rol toevoegt met serverbeheer. Zie Managed Object Format (MOF) voor meer informatie over MOF-bestanden.

Behoeften

Voorwaarde Waarde
Minimaal ondersteunde client
Windows Vista Enterprise, Windows Vista Ultimate [alleen desktop-apps]
Minimaal ondersteunde server
Windows Server 2008 [alleen desktop-apps]
Namespace
Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Zie ook

Win32_EncryptableVolume