Metode ProtectKeyWithNumericalPassword dari kelas Win32_EncryptableVolume

Metode ProtectKeyWithNumericalPassword dari kelas Win32_EncryptableVolume mengamankan kunci enkripsi volume dengan kata sandi 48 digit yang diformat khusus. Kata sandi numerik ini dapat digunakan untuk memulihkan dari kegagalan autentikasi pelindung kunci lainnya (misalnya, TPM).

Pelindung kunci jenis "Kata Sandi Numerik" dibuat untuk volume.

Gunakan metode IsNumericalPasswordValid untuk memvalidasi format kata sandi numerik.

Sintaksis

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

Parameter-parameternya

FriendlyName [in, opsional]

Jenis: string

String yang menentukan pengidentifikasi yang ditetapkan pengguna untuk pelindung kunci ini. Jika parameter ini tidak ditentukan, nilai kosong akan digunakan.

NumericalPassword [in, opsional]

Jenis: string

String yang menentukan kata sandi numerik 48 digit yang diformat khusus.

Kata sandi numerik harus berisi 48 digit. Digit ini dapat dibagi menjadi 8 grup 6 digit, dengan digit terakhir di setiap grup yang menunjukkan nilai checksum untuk grup. Setiap grup 6 digit harus dapat dibagi 11 dan harus 720885 atau kurang. Dengan asumsi sekelompok enam digit diberi label sebagai x1, x2, x3, x4, x5, dan x6, checksum x6 digit dihitung sebagai –x1+x2–x3+x4–x5 mod 11.

Grup digit secara opsional dapat dipisahkan oleh spasi atau tanda hubung. Oleh karena itu, "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" atau "xxxxx" atau "xxxxxx xxxxxx xxxxxx xxxxxx xxx xxx xx" mungkin juga berisi kata sandi numerik yang valid.

Jika tidak ada kata sandi numerik yang ditentukan, kata sandi akan dibuat secara acak. Gunakan metode GetKeyProtectorNumericalPassword untuk mendapatkan kata sandi yang dihasilkan secara acak.

VolumeKeyProtectorID [out]

Jenis: string

String yang merupakan pengidentifikasi unik yang terkait dengan pelindung yang dibuat dan yang dapat digunakan untuk mengelola pelindung kunci.

Jika drive mendukung enkripsi perangkat keras dan BitLocker belum mengambil kepemilikan band, string ID diatur ke "BitLocker" dan pelindung kunci ditulis ke metadata per pita.

Mengembalikan nilai

Jenis: uint32

Metode ini mengembalikan salah satu kode berikut atau kode kesalahan lain jika gagal.

Mengembalikan kode/nilai Deskripsi
S_OK
0 (0x0)
 Metode berhasil.
E_INVALIDARG
2147942487 (0x80070057)
 Parameter NumericalPassword tidak memiliki format yang valid.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Volume dikunci.
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
 Parameter NumericalPassword tidak memiliki format yang valid.

 

Komentar

File Managed Object Format (MOF) berisi definisi untuk kelas Windows Management Instrumentation (WMI). File MOF tidak diinstal sebagai bagian dari Windows SDK. Mereka diinstal di server saat Anda menambahkan peran terkait dengan menggunakan Manajer Server. Untuk informasi selengkapnya tentang file MOF, lihat Managed Object Format (MOF).

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista Enterprise, Windows Vista Ultimate [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2008 [hanya aplikasi desktop]
Namespace layanan
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Lihat juga

Win32_EncryptableVolume

 

 

  • Last updated on