função Tbsi_Context_Create (tbs.h)

  • Artigo

Cria um identificador de contexto que pode ser usado para passar comandos para o TBS.

Sintaxe

TBS_RESULT Tbsi_Context_Create(
  [in]  PCTBS_CONTEXT_PARAMS pContextParams,
  [out] PTBS_HCONTEXT        phContext
);

Parâmetros

[in] pContextParams

Um parâmetro para uma estrutura TBS_CONTEXT_PARAMS que contém os parâmetros associados ao contexto.

[out] phContext

Um ponteiro para um local para armazenar o novo identificador de contexto.

Retornar valor

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_BAD_PARAMETER
2150121474 (0x80284002)
 Um ou mais valores de parâmetro não são válidos.
TBS_E_INTERNAL_ERROR
2150121473 (0x80284001)
 Ocorreu um erro interno de software.
TBS_E_INVALID_CONTEXT_PARAM
2150121479 (0x80284007)
 Um parâmetro de contexto que não é válido foi passado ao tentar criar um contexto de TBS.
TBS_E_INVALID_OUTPUT_POINTER
2150121475 (0x80284003)
 Um ponteiro de saída especificado não é válido.
TBS_E_SERVICE_DISABLED
2150121488 (0x80284010)
 O serviço TBS foi desabilitado.
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
 O serviço TBS não está em execução e não pôde ser iniciado.
TBS_E_SERVICE_START_PENDING
2150121483 (0x8028400B)
 O serviço TBS foi iniciado, mas ainda não está em execução.
TBS_E_TOO_MANY_TBS_CONTEXTS
2150121481 (0x80284009)
 Não foi possível criar um novo contexto porque há muitos contextos abertos.
TBS_E_TPM_NOT_FOUND
2150121487 (0x8028400F)
 Um dispositivo de segurança TPM (Trusted Platform Module) compatível não pode ser encontrado neste computador.

Comentários

A estrutura TBS_CONTEXT_PARAMS pode ser fornecida, com o campo de versão definido como TPM_VERSION_12. Os aplicativos que interagem com o TPM da versão 2.0 passarão um ponteiro para uma estrutura TBS_CONTEXT_PARAMS2 , com o campo de versão definido como TPM_VERSION_20. Defina o campo reservado como 0 e o campo includeTPm20 como 1. Se o aplicativo estiver preparado para interagir com um TPM versão 1.2 também (caso o sistema não tenha nenhuma versão 2.0 TPM), defina o campo includeTpm12 como 1.

Se nenhum TPM estiver presente no sistema ou a versão do TPM não corresponder às solicitadas pelo chamador, Tbsi_Context_Create retornará o código de erro TBS_E_TPM_NOT_FOUND (0x8028400). Os programas de aplicativo devem marcar para ambas as versões e poder interagir com qualquer um dos TPM.

Requisitos

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