Win32_Tpm 클래스의 TakeOwnership 메서드

  • 아티클

Win32_Tpm 클래스의 TakeOwnership 메서드는 TPM에 대한 소유자를 설치합니다. TPM 소유자는 TPM 기능을 최대한 활용할 수 있습니다. 소유자가 설정되면 다른 사용자 또는 소프트웨어가 TPM의 소유권을 주장할 수 없습니다.

TakeOwnership 메서드가 성공하려면 IsEnabled, IsActivated 및 IsOwnershipAllowed 메서드가 모두 true여야 합니다.

구문

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

매개 변수

OwnerAuth [in, optional]

형식: 문자열

TPM 소유자를 식별하는 문자열입니다. 이 문자열은 정확히 20바이트의 이진 데이터를 포함하는 base64로 인코딩된 null로 끝나는 문자열이어야 합니다. ConvertToOwnerAuth 메서드를 사용하여 암호를 이 예상 형식으로 변환합니다. OwnerAuth 매개 변수는 제공되지 않은 경우 레지스트리에서 읽습니다.

반환 값

형식: uint32

TPM 기본 서비스와 관련된 모든 TPM 오류와 오류를 반환할 수 있습니다.

다음 표에는 몇 가지 일반적인 반환 코드가 나와 있습니다.

반환 코드/값 Description
S_OK
0(0x0)
 메서드를 성공적으로 수행했습니다.
E_INVALIDARG
2147942487(0x80070057)
 OwnerAuth 매개 변수가 잘못되었습니다.
TPM_E_OWNER_SET
2150105108(0x80280014)
 TPM에 소유자가 이미 있습니다.
TPM_E_NO_ENDORSEMENT
2150105123(0x80280023)
 TPM에서 인증 키를 찾을 수 없습니다.
TPM에서 인증 키 쌍을 만들려면 CreateEndorsementKeyPair 메서드를 참조하세요.
TPM_E_INSTALL_DISABLED
2150105099(0x8028000B)
 이 TPM에는 소유자를 설치할 수 없습니다.
디바이스 소유자의 설치를 허용하는 방법에 대한 자세한 내용은 SetPhysicalPresenceRequest를 참조하세요.
TPM_E_DEFEND_LOCK_RUNNING
2150107139(0x80280803)
 TPM은 사전 공격을 방어하고 있으며 시간 제한 기간에 있습니다. 자세한 내용은 ResetAuthLockOut 메서드를 참조하세요.

 

설명

TakeOwnership이 성공하려면 IsEnabled, IsActivated 및 IsOwnershipAllowed 메서드가 모두 true여야 합니다.

ConvertToOwnerAuth 메서드를 사용하여 암호를 OwnerAuth 매개 변수에 사용되는 입력 값으로 변경해야 합니다.

적절한 그룹 정책 설정이 구성된 경우 TakeOwnership 메서드는 소유자 권한 부여 값을 Active Directory에 백업합니다.

MOF(Managed Object Format) 파일에는 WMI(Windows Management Instrumentation) 클래스에 대한 정의가 포함되어 있습니다. MOF 파일은 Windows SDK의 일부로 설치되지 않습니다. 서버 관리자 사용하여 연결된 역할을 추가할 때 서버에 설치됩니다. MOF 파일에 대한 자세한 내용은 MOF(관리 개체 형식)를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
네임스페이스
 Root\CIMV2\Security\MicrosoftTpm
MOF
Win32_tpm.mof
DLL
Win32_tpm.dll

추가 정보

Win32_Tpm