Metode ChangeExternalKey dari kelas Win32_EncryptableVolume

  • Artikel

Metode ChangeExternalKey dari kelas Win32_EncryptableVolume mengubah kunci eksternal yang terkait dengan volume terenkripsi.

Sintaks

uint32 ChangeExternalKey(
  [in]           string VolumeKeyProtectorID,
  [in, optional] uint8   NewExternalKey[],
  [out]          string NewVolumeKeyProtectorID
);

Parameter

VolumeKeyProtectorID [in]

Jenis: string

Pengidentifikasi string unik yang digunakan untuk mengelola pelindung kunci volume terenkripsi.

NewExternalKey [in, opsional]

Jenis: uint8[]

Array byte yang menentukan kunci eksternal 256-bit yang digunakan untuk membuka kunci volume.

NewVolumeKeyProtectorID [out]

Jenis: string

Pengidentifikasi string unik yang diperbarui yang digunakan untuk mengelola pelindung kunci volume terenkripsi.

Nilai kembali

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 NewExternalKey bukan array dengan ukuran 32.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Volume dikunci.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker tidak diaktifkan pada volume. Tambahkan pelindung kunci untuk mengaktifkan BitLocker.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 CD/DVD yang dapat di-boot ditemukan di komputer ini. Hapus CD/DVD dan mulai ulang komputer.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 Pelindung kunci yang disediakan tidak ada pada volume.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 Parameter VolumeKeyProtectorID tidak merujuk ke pelindung kunci dari jenis "Kata Sandi Numerik" atau "Kunci Eksternal". Gunakan metode ProtectKeyWithNumericalPassword atau ProtectKeyWithExternalKey untuk membuat pelindung kunci dengan jenis yang sesuai.

 

Keterangan

Metode ini dapat digunakan untuk mengubah kunci eksternal untuk pelindung kunci apa pun yang menggunakan kunci eksternal.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 7 Enterprise, Windows 7 Ultimate [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2008 R2 [hanya aplikasi desktop]
Ruang nama
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Lihat juga

Win32_EncryptableVolume