ProtectKeyWithNumericalPassword, metoda klasy Win32_EncryptableVolume

Metoda ProtectKeyWithNumericalPassword klasy Win32_EncryptableVolume zabezpiecza klucz szyfrowania woluminu przy użyciu specjalnie sformatowanego 48-cyfrowego hasła. To hasło liczbowe może służyć do odzyskiwania po błędach uwierzytelniania innych funkcji ochrony kluczy (na przykład modułu TPM).

Dla woluminu jest tworzona funkcja ochrony klucza typu "Hasło numeryczne".

Użyj metody IsNumericalPasswordValid , aby zweryfikować format hasła liczbowego.

Składnia

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

Parametry

FriendlyName [in, opcjonalnie]

Typ: ciąg

Ciąg określający identyfikator przypisany przez użytkownika dla tej funkcji ochrony klucza. Jeśli ten parametr nie zostanie określony, zostanie użyta pusta wartość.

Wartośćnumerysyjna [in, opcjonalna]

Typ: ciąg

Ciąg określający specjalnie sformatowane 48-cyfrowe hasło liczbowe.

Hasło numeryczne musi zawierać 48 cyfr. Te cyfry można podzielić na 8 grup z 6 cyframi, z ostatnią cyfrą w każdej grupie wskazującą wartość sumy kontrolnej dla grupy. Każda grupa 6 cyfr musi być podzielna przez 11 i musi być 720885 lub mniejsza. Przy założeniu, że grupa sześciu cyfr jest oznaczona jako x1, x2, x3, x4, x5 i x6, cyfra sumy kontrolnej x6 jest obliczana jako –x1+x2–x3+x4–x4–x5 mod 11.

Grupy cyfr można opcjonalnie rozdzielić spacją lub łącznikiem. W związku z tym "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" lub "xxxxxx xxxxxx" może również zawierać prawidłowe hasła liczbowe.

Jeśli nie określono żadnego hasła liczbowego, jest generowany losowo. Użyj metody GetKeyProtectorNumericalPassword , aby uzyskać losowo wygenerowane hasło.

VolumeKeyProtectorID [out]

Typ: ciąg

Ciąg, który jest unikatowym identyfikatorem skojarzonym z utworzoną funkcją ochrony i którego można użyć do zarządzania funkcją ochrony klucza.

Jeśli dysk obsługuje szyfrowanie sprzętowe, a funkcja BitLocker nie przejęła własności pasm, ciąg identyfikatora jest ustawiony na wartość "BitLocker", a funkcja ochrony klucza jest zapisywana w metadanych poszczególnych przedziałów.

Wartość zwracana

Typ: uint32

Ta metoda zwraca jeden z następujących kodów lub inny kod błędu, jeśli zakończy się niepowodzeniem.

Zwracanie kodu/wartości	Opis
S_OK 0 (0x0)	Metoda zakończyła się pomyślnie.
E_INVALIDARG 2147942487 (0x80070057)	Parametr NumericalPassword nie ma prawidłowego formatu.
FVE_E_LOCKED_VOLUME 2150694912 (0x80310000)	Wolumin jest zablokowany.
FVE_E_INVALID_PASSWORD_FORMAT 2150694965 (0x80310035)	Parametr NumericalPassword nie ma prawidłowego formatu.

 

Uwagi

Pliki formatu obiektów zarządzanych (MOF) zawierają definicje klas Instrumentacji zarządzania Windows (WMI). Pliki MOF nie są instalowane jako część zestawu Windows SDK. Są one instalowane na serwerze po dodaniu skojarzonej roli przy użyciu Menedżera serwera. Aby uzyskać więcej informacji na temat plików MOF, zobacz Managed Object Format (MOF).

Wymagania

Wymaganie	Wartość
Minimalny obsługiwany klient	Windows Vista Enterprise, Windows Vista Ultimate [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows Server 2008 [tylko aplikacje klasyczne]
Namespace	Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF	Win32_encryptablevolume.mof

Zobacz także

Win32_EncryptableVolume