Metode TakeOwnership dari kelas Win32_Tpm
Metode TakeOwnership dari kelas Win32_Tpm menginstal pemilik untuk TPM. Pemilik TPM dapat menggunakan sepenuhnya kemampuan TPM. Setelah pemilik ditetapkan, tidak ada pengguna atau perangkat lunak lain yang dapat mengklaim kepemilikan TPM.
Metode IsEnabled, IsActivated, dan IsOwnershipAllowed semuanya harus benar sebelum metode TakeOwnership dapat berhasil.
Sintaks
uint32 TakeOwnership(
[in, optional] string OwnerAuth
);
Parameter
-
OwnerAuth [in, opsional]
-
Jenis: string
String yang mengidentifikasi pemilik TPM. String ini harus berupa string yang dikodekan dengan base64 null-terminated yang berisi tepat 20 byte data biner. Gunakan metode ConvertToOwnerAuth untuk menerjemahkan frasa sandi ke format yang diharapkan ini. Parameter OwnerAuth dibaca dari registri jika tidak ada yang disediakan.
Nilai kembali
Jenis: uint32
Semua kesalahan TPM serta kesalahan khusus untuk Layanan Dasar TPM dapat dikembalikan.
Tabel berikut mencantumkan beberapa kode pengembalian umum.
| Mengembalikan kode/nilai | Deskripsi |
|---|---|
|
Metode berhasil. |
|
Parameter OwnerAuth tidak valid. |
|
Pemilik sudah ada di TPM. |
|
Tidak ada kunci dukungan yang dapat ditemukan pada TPM. Untuk membuat pasangan kunci dukungan pada TPM, lihat metode CreateEndorsementKeyPair . |
|
Pemilik tidak dapat diinstal pada TPM ini. Untuk informasi tentang cara mengizinkan penginstalan pemilik perangkat, lihat SetPhysicalPresenceRequest. |
|
TPM bertahan dari serangan kamus dan berada dalam periode waktu habis. Untuk informasi selengkapnya, lihat metode ResetAuthLockOut . |
Keterangan
Metode IsEnabled, IsActivated, dan IsOwnershipAllowed semuanya harus benar sebelum TakeOwnership dapat berhasil.
Anda harus menggunakan metode ConvertToOwnerAuth untuk mengubah frasa sandi menjadi nilai input yang digunakan untuk parameter OwnerAuth .
Metode TakeOwnership mencadangkan nilai otorisasi pemilik ke Direktori Aktif jika pengaturan Kebijakan Grup yang sesuai telah dikonfigurasi.
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 [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2008 [hanya aplikasi desktop] |
| Ruang nama |
Root\CIMV2\Security\MicrosoftTpm |
| MOF |
|
| DLL |
|
Lihat juga