clear 方法Win32_Tpm類別

Win32_Tpm類別的Clear方法會將 TPM 重設為其原廠預設狀態。 TPM 擁有者可以使用這個方法來取消 TPM 擁有權，並使先前擁有者所建立的密碼編譯資料失效。 如果呼叫 可能會導致需要 BitLocker 復原，這個方法會暫停 BitLocker。 布建 TPM 之後，BitLocker 會自動繼續。

警告

藉由清除 TPM，您將失去應用程式所建立和使用的所有 TPM 金鑰。 如果這些金鑰是用來加密資料，請確定您有另一種方式可以存取資料，然後再清除 TPM。

 

語法

uint32 Clear(
  [in, optional] string OwnerAuth
);

參數

OwnerAuth [in， optional]

類型： 字串

識別 TPM 擁有者的字串。 此字串必須是 base64 編碼的字串，其中包含 20 個位元組的二進位資料。 使用 ConvertToOwnerAuth 方法，將複雜密碼轉譯為預期的格式。 如果沒有提供，則會從登錄讀取 OwnerAuth 參數。

傳回值

類型： uint32

您可以傳回所有 TPM 錯誤，以及 TPM 基底服務特有的錯誤。

下表列出一些常見的傳回碼。

傳回碼/值	描述
S_OK 0 (0x0)	此方法成功。
TPM_E_AUTHFAIL 2150105089 (0x80280001)	提供的擁有者授權值無法執行要求。
TPM_E_DEFEND_LOCK_RUNNING 2150107139 (0x80280803)	TPM 正在防禦字典攻擊，並處於逾時期間。 如需詳細資訊，請參閱 ResetAuthLockOut 方法。

 

備註

執行此方法可協助準備具備 TPM 功能的電腦以進行回收。

若要清除 TPM，但不再擁有 TPM 擁有者授權，您需要實際存取電腦。 SetPhysicalPresenceRequest方法包含可協助清除 TPM 而不需 TPM 擁有者授權的功能。

Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Windows SDK 的一部分。 當您使用 伺服器管理員 新增相關聯的角色時，它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊，請參閱 Managed Object Format (MOF) 。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
命名空間	Root\CIMV2\Security\MicrosoftTpm
MOF	Win32_tpm.mof
DLL	Win32_tpm.dll

另請參閱

Win32_Tpm