Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ChangeOwnerAuth method of the Win32_Tpm class

The ChangeOwnerAuth method of the Win32_Tpm class changes the TPM owner authorization value.

Syntax


uint32 ChangeOwnerAuth(
  [in, optional]  string OldOwnerAuth,
  [in, optional]  string NewOwnerAuth
);

Parameters

OldOwnerAuth [in, optional]

Type: string

A string that names the current TPM owner authorization value of the device. Use the ConvertToOwnerAuth method to translate a password to this authorization value. The OldOwnerAuth parameter is not supplied or an empty string is provided, this method gets the value from the registry if present.

NewOwnerAuth [in, optional]

Type: string

A string that names the new TPM owner authorization value. Use the ConvertToOwnerAuth method to translate a password to this authorization value. The NewOwnerAuth parameter cannot be empty or NULL.

Return value

Type: uint32

All TPM errors as well as errors specific to TPM Base Services can be returned.

The following table lists some of the common return codes.

Return code/valueDescription
S_OK
0 (0x0)

The method was successful.

TPM_E_AUTHFAIL
2150105089 (0x80280001)

The current TPM owner authorization value is incorrect.

TPM_E_DEFEND_LOCK_RUNNING
2150107139 (0x80280803)

The TPM is defending against dictionary attacks and is in a time-out period. For more information, see the ResetAuthLockOut method.

FVE_E_AD_SCHEMA_NOT_INSTALLED
2150694922 (0x8031000A)

Cannot save recovery information to the network. The computer has been configured to store recovery information to Active Directory Domain Services. For instructions on how to set up Active Directory, see BitLocker Drive Encryption Configuration Guide: Backing Up BitLocker and TPM Recovery Information to Active Directory.

Connection Failed
2147943755 (0x8007054B)

Cannot save recovery information to the network. The computer has been configured to store recovery information to Active Directory Domain Services. A network connection is required to continue.

 

Remarks

The ChangeOwnerAuth method backs up the new TPM owner authorization to Active Directory Domain Services if the appropriate Group Policy settings have been configured.

Managed Object Format (MOF) files contain the definitions for Windows Management Instrumentation (WMI) classes. MOF files are not installed as part of the Windows SDK. They are installed on the server when you add the associated role by using the Server Manager. For more information about MOF files, see Managed Object Format (MOF).

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Namespace

\\.\root\CIMV2\Security\MicrosoftTpm

MOF

Win32_tpm.mof

DLL

Win32_tpm.dll

See also

Win32_Tpm

 

 

Community Additions

Show:
© 2014 Microsoft