Metode UnlockWithNumericalPassword dari kelas Win32_EncryptableVolume

Metode UnlockWithNumericalPassword dari kelas Win32_EncryptableVolume menggunakan kata sandi numerik yang disediakan untuk mengakses konten volume data.

Kunci enkripsi volume harus diamankan dengan satu atau beberapa pelindung kunci dari jenis "Kata Sandi Numerik" (dengan menggunakan metode ProtectKeyWithNumericalPassword ) untuk dapat membuka kunci volume dengan metode ini.

Catatan

Jika disk mendukung enkripsi perangkat keras, fungsi ini mengatur status pita menjadi "tidak terkunci""

 

Sintaks

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

Parameter

NumericalPassword [in]

Jenis: string

String yang menentukan kata sandi numerik.

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 kurang dari 65536. Dengan asumsi sekelompok enam digit diberi label sebagai x1, x2, x3, x4, x5, dan x6, digit checksum x6 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-xxxxxx" atau "xxxxxx xxxxxxx xxxxxx xxxxxx xxxxxx xxxx xx" mungkin juga berisi kata sandi numerik yang valid.

Nilai kembali

Jenis: uint32

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

Jika volume sudah dibuka dan tidak ada kesalahan lain yang terjadi, metode ini mengembalikan 0.

Mengembalikan kode/nilai	Deskripsi
S_OK 0 (0x0)	Metode berhasil.
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	BitLocker tidak diaktifkan pada volume. Tambahkan pelindung kunci untuk mengaktifkan BitLocker.
FVE_E_PROTECTOR_NOT_FOUND 2150694963 (0x80310033)	Volume tidak memiliki pelindung kunci dari jenis "Kata Sandi Numerik". Parameter NumericalPassword memiliki format yang valid, tetapi Anda tidak dapat menggunakan kata sandi numerik untuk membuka kunci volume.
FVE_E_FAILED_AUTHENTICATION 2150694951 (0x80310027)	Parameter NumericalPassword tidak dapat membuka kunci volume. Ada satu atau beberapa pelindung kunci dari jenis "Kata Sandi Numerik", tetapi parameter NumericalPassword yang ditentukan tidak dapat membuka kunci volume.
FVE_E_INVALID_PASSWORD_FORMAT 2150694965 (0x80310035)	Parameter NumericalPassword tidak memiliki format yang valid.

 

Keterangan

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]
Ruang nama	Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF	Win32_encryptablevolume.mof

Lihat juga

Win32_EncryptableVolume