Share via

Método TakeOwnership de la clase Win32_Tpm

  • Artículo

El método TakeOwnership de la clase Win32_Tpm instala un propietario para el TPM. El propietario del TPM puede sacar el máximo partido de las funcionalidades de TPM. Una vez establecido un propietario, ningún otro usuario o software puede reclamar la propiedad del TPM.

Los métodos IsEnabled, IsActivated e IsOwnershipAllowed deben ser true para que el método TakeOwnership pueda realizarse correctamente.

Sintaxis

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

Parámetros

OwnerAuth [in, opcional]

Tipo: cadena

Cadena que identifica al propietario del TPM. Esta cadena debe ser una cadena terminada en NULL codificada en base64 que contenga exactamente 20 bytes de datos binarios. Use el método ConvertToOwnerAuth para traducir una frase de contraseña a este formato esperado. El parámetro OwnerAuth se lee desde el registro si no se proporciona ninguno.

Valor devuelto

Tipo: uint32

Se pueden devolver todos los errores de TPM, así como los errores específicos de los servicios base de TPM.

En la tabla siguiente se enumeran algunos de los códigos de retorno comunes.

Código o valor devuelto Descripción
S_OK
0 (0x0)
 Método realizado correctamente.
E_INVALIDARG
2147942487 (0x80070057)
 El parámetro OwnerAuth no es válido.
TPM_E_OWNER_SET
2150105108 (0x80280014)
 Ya existe un propietario en el TPM.
TPM_E_NO_ENDORSEMENT
2150105123 (0x80280023)
 No se puede encontrar ninguna clave de aprobación en el TPM.
Para crear un par de claves de aprobación en el TPM, consulte el método CreateEndorsementKeyPair .
TPM_E_INSTALL_DISABLED
2150105099 (0x8028000B)
 No se puede instalar un propietario en este TPM.
Para obtener información sobre cómo permitir la instalación de un propietario del dispositivo, consulte SetPhysicalPresenceRequest.
TPM_E_DEFEND_LOCK_RUNNING
2150107139 (0x80280803)
 El TPM está defendiendo contra ataques de diccionario y está en un período de tiempo de espera. Para obtener más información, vea el método ResetAuthLockOut .

 

Comentarios

Los métodos IsEnabled, IsActivated e IsOwnershipAllowed deben ser true para que TakeOwnership pueda realizarse correctamente.

Debe usar el método ConvertToOwnerAuth para cambiar una frase de contraseña en el valor de entrada utilizado para el parámetro OwnerAuth .

El método TakeOwnership realiza una copia de seguridad del valor de autorización del propietario en Active Directory si se han configurado las opciones de directiva de grupo adecuadas.

Los archivos managed Object Format (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Los archivos MOF no se instalan como parte de Windows SDK. Se instalan en el servidor cuando se agrega el rol asociado mediante el Administrador del servidor. Para obtener más información sobre los archivos MOF, vea Managed Object Format (MOF) (Formato de objeto administrado [MOF]).

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2008 [solo aplicaciones de escritorio]
Espacio de nombres
 Root\CIMV2\Security\MicrosoftTpm
MOF
Win32_tpm.mof
Archivo DLL
Win32_tpm.dll

Consulte también

Win32_Tpm