Metode ChangePIN dari kelas Win32_EncryptableVolume

Artikel
06/13/2023

Metode ChangePIN dari kelas Win32_EncryptableVolume mengubah PIN yang terkait dengan volume terenkripsi. Jika kebijakan grup "Izinkan PIN yang ditingkatkan untuk startup" diaktifkan, PIN dapat berisi huruf, simbol, dan spasi selain angka.

Sintaks

uint32 ChangePIN(
  [in] string VolumeKeyProtectorID,
  [in] string NewPIN
);

Parameter

VolumeKeyProtectorID [in]

Jenis: string

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

NewPIN [in]

Jenis: string

String identifikasi pribadi yang ditentukan pengguna. String ini harus terdiri dari urutan 4 hingga 20 digit atau, jika kebijakan grup "Izinkan VPN yang ditingkatkan untuk startup" diaktifkan, 4 hingga 20 huruf, simbol, spasi, atau angka.

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.
FVE_E_BOOTABLE_CDDVD 2150694960 (0x80310030)	CD/DVD yang bisa di-boot ditemukan di komputer ini. Hapus CD/DVD dan mulai ulang komputer.
FVE_E_INVALID_PIN_CHARS 2150695066 (0x8031009A)	Parameter NewPIN berisi karakter yang tidak valid. Ketika Kebijakan Grup "Izinkan VPN yang disempurnakan untuk startup" dinonaktifkan, hanya angka yang didukung.
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 dari jenis yang sesuai.
FVE_E_LOCKED_VOLUME 2150694912 (0x80310000)	Volume terkunci.
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	BitLocker tidak diaktifkan pada volume. Tambahkan pelindung kunci untuk mengaktifkan BitLocker.
FVE_E_POLICY_INVALID_PIN_LENGTH 2150695016 (0x80310068)	Parameter NewPIN yang disediakan lebih panjang dari 20 karakter, lebih pendek dari 4 karakter, atau lebih pendek dari panjang minimum yang ditentukan oleh Kebijakan Grup.
FVE_E_PROTECTOR_NOT_FOUND 2150694963 (0x80310033)	Pelindung kunci yang disediakan tidak ada pada volume.
TBS_E_SERVICE_NOT_RUNNING 2150121480 (0x80284008)	Tidak ditemukan Modul Platform Tepercaya (TPM) yang kompatibel pada komputer ini.

Keterangan

Metode ChangePIN membuat pelindung TPM dan PIN baru berdasarkan informasi pelindung yang ada dan PIN yang baru disediakan. Pelindung baru akan memiliki GUID yang sama. Metode ChangePIN juga dapat dipanggil untuk mengubah PIN pelindung kunci apa pun yang menggunakan PIN, misalnya, TPM dan PIN atau TPM dengan PIN dan USB.

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

Bagikan melalui