Metode UnlockWithExternalKey dari kelas Win32_EncryptableVolume

  • Artikel

Metode UnlockWithExternalKey dari kelas Win32_EncryptableVolume menggunakan kunci eksternal yang disediakan untuk mengakses konten volume data.

Kunci enkripsi volume harus diamankan dengan satu atau beberapa pelindung kunci dari jenis "Kunci Eksternal" menggunakan metode ProtectKeyWithExternalKey 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 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

Parameter

ExternalKey [in]

Jenis: uint8[]

Array byte yang menentukan kunci eksternal 256-bit yang digunakan untuk membuka kunci volume. Kunci ini dapat diperoleh dengan memanggil metode GetExternalKeyFromFile .

Menampilkan nilai

Jenis: uint32

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

Jika volume sudah tidak terkunci, metode ini mengembalikan 0.

Mengembalikan kode/nilai Deskripsi
S_OK
0 (0x0)
 Metode berhasil.
ERROR_NOT_FOUND
Tidak ada nilai yang diberikan (0x)
 Volume tidak memiliki pelindung kunci dari jenis "Kunci Eksternal".
ERROR_INVALID_PASSWORD
Tidak ada nilai yang diberikan (0x)
 Ada satu atau beberapa pelindung kunci dari jenis "Kunci Eksternal", tetapi parameter ExternalKey yang ditentukan tidak dapat membuka kunci volume.
E_INVALIDARG
2147942487 (0x80070057)
 Parameter ExternalKey bukan array dengan ukuran 4.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker tidak diaktifkan pada volume. Tambahkan pelindung kunci untuk mengaktifkan BitLocker.

 

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 ketika 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