Compartilhar via


função Tbsi_Get_OwnerAuth (tbs.h)

Recupera a autorização do proprietário do TPM se as informações estiverem disponíveis no registro local.

Sintaxe

TBS_RESULT Tbsi_Get_OwnerAuth(
  [in]            TBS_HCONTEXT       hContext,
  [in]            TBS_OWNERAUTH_TYPE ownerauthType,
  [out, optional] PBYTE              pOutputBuf,
  [in, out]       PUINT32            pOutputBufLen
);

Parâmetros

[in] hContext

Identificador TBS obtido de uma chamada anterior para a função Tbsi_Context_Create .

[in] ownerauthType

Inteiro de 32 bits sem sinal que indica o tipo de autenticação do proprietário.

Valor Significado
TBS_OWNERAUTH_TYPE_FULL
1
A autorização do proprietário está cheia.
TBS_OWNERAUTH_TYPE_ADMIN
2
Nota Somente TPM 1.2

A autorização do proprietário é um administrador.

TBS_OWNERAUTH_TYPE_USER
3
Nota Somente TPM 1.2

A autorização do proprietário é um usuário.

TBS_OWNERAUTH_TYPE_ENDORSEMENT
4
Nota Somente TPM 1.2

A autorização do proprietário é uma autorização de endosso.

TBS_OWNERAUTH_TYPE_ENDORSEMENT_20
12
Nota TPM 2.0 e posterior

A autorização do proprietário é uma autorização de endosso.

TBS_OWNERAUTH_TYPE_STORAGE_20
13
Nota TPM 2.0 e posterior

A autorização do proprietário é um administrador.

[out, optional] pOutputBuf

Um ponteiro para um buffer para receber as informações de autorização do proprietário do TPM.

[in, out] pOutputBufLen

Um inteiro que, na entrada, especifica o tamanho, em bytes, do buffer de saída. No retorno bem-sucedido, esse valor é definido como o tamanho real do ownerAuth do TPM, em bytes.

Valor retornado

Se a função for bem-sucedida, a função retornará TBS_SUCCESS.

Se a função falhar, ela retornará um código de retorno de TBS que indica o erro.

Valor/código retornado Descrição
TBS_SUCCESS
0 (0x0)
A função foi bem-sucedida.
TBS_E_OWNERAUTH_NOT_FOUND
2150121493 (0x80284015)
O valor de ownerAuth do TPM solicitado não foi encontrado.
TBS_E_BAD_PARAMETER
2150121474 (0x80284002)
O valor ownerAuth do TPM solicitado não corresponde à versão do TPM.

Comentários

Há valores de autorização adicionais, também conhecidos como blobs de delegação, derivados do ownerAuth completo do TPM que permitem que um subconjunto da funcionalidade do TPM seja executado. O administrador pode configurar o nível de ownerAuth que deve ser armazenado localmente no registro por meio de Política de Grupo e o mesmo pode ser obtido nessa chamada à API.

Se o backup de ownerAuth do Active Directory estiver habilitado por meio de Política de Grupo, o nível padrão de ownerAuth será definido como Delegado, o que significa que a autenticação completa do proprietário é removida do registro local e armazenada no Active Directory. Somente blobs de delegação são armazenados localmente no registro nesse caso. Embora o nível de armazenamento ownerAuth possa ser configurado explicitamente como Completo, resultando no proprietário do TPMAuth estar disponível localmente no registro.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho tbs.h
Biblioteca Tbs.lib
DLL Tbs.dll