función Tbsi_Context_Create (tbs.h)

  • Artículo

Crea un identificador de contexto que se puede usar para pasar comandos a TBS.

Sintaxis

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

Parámetros

[in] pContextParams

Parámetro de una estructura TBS_CONTEXT_PARAMS que contiene los parámetros asociados al contexto.

[out] phContext

Puntero a una ubicación para almacenar el nuevo identificador de contexto.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve TBS_SUCCESS.

Si se produce un error en la función, devuelve un código de retorno TBS que indica el error.

Código o valor devuelto Descripción
TBS_SUCCESS
0 (0x0)
 La función se realizó correctamente.
TBS_E_BAD_PARAMETER
2150121474 (0x80284002)
 Uno o varios valores de parámetro no son válidos.
TBS_E_INTERNAL_ERROR
2150121473 (0x80284001)
 Error interno de software.
TBS_E_INVALID_CONTEXT_PARAM
2150121479 (0x80284007)
 Se pasó un parámetro de contexto que no es válido al intentar crear un contexto TBS.
TBS_E_INVALID_OUTPUT_POINTER
2150121475 (0x80284003)
 Un puntero de salida especificado no es válido.
TBS_E_SERVICE_DISABLED
2150121488 (0x80284010)
 El servicio TBS se ha deshabilitado.
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
 El servicio TBS no se está ejecutando y no se pudo iniciar.
TBS_E_SERVICE_START_PENDING
2150121483 (0x8028400B)
 Se ha iniciado el servicio TBS, pero aún no se está ejecutando.
TBS_E_TOO_MANY_TBS_CONTEXTS
2150121481 (0x80284009)
 No se pudo crear un nuevo contexto porque hay demasiados contextos abiertos.
TBS_E_TPM_NOT_FOUND
2150121487 (0x8028400F)
 No se encuentra un dispositivo de seguridad del módulo de plataforma segura (TPM) compatible en este equipo.

Comentarios

Se puede proporcionar la estructura TBS_CONTEXT_PARAMS , con el campo de versión establecido en TPM_VERSION_12. Las aplicaciones que interactúan con la versión 2.0 de TPM pasarán un puntero a una estructura de TBS_CONTEXT_PARAMS2 , con el campo de versión establecido en TPM_VERSION_20. Establezca el campo reservado en 0 y el campo includeTPm20 en 1. Si la aplicación está preparada para interactuar con un TPM de la versión 1.2 (en caso de que el sistema no tenga versión 2.0 TPM), establezca el campo includeTpm12 en 1.

Si no hay ningún TPM presente en el sistema o la versión de TPM no coincide con las solicitadas por el autor de la llamada, Tbsi_Context_Create devolverá el código de error de TBS_E_TPM_NOT_FOUND (0x8028400). Los programas de aplicación deben comprobar ambas versiones y poder interactuar con cualquier TPM.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tbs.h
Library Tbs.lib
Archivo DLL Tbs.dll