función Tbsip_Submit_Command (tbs.h)

Artículo
08/26/2023

Envía un comando módulo de plataforma segura (TPM) a TPM Base Services (TBS) para su procesamiento.

Sintaxis

TBS_RESULT Tbsip_Submit_Command(
  [in]      TBS_HCONTEXT         hContext,
  [in]      TBS_COMMAND_LOCALITY Locality,
  [in]      TBS_COMMAND_PRIORITY Priority,
  [in]      PCBYTE               pabCommand,
  [in]      UINT32               cbCommand,
  [out]     PBYTE                pabResult,
  [in, out] PUINT32              pcbResult
);

Parámetros

[in] hContext

Identificador del contexto que envía el comando.

[in] Locality

Se usa para establecer la localidad del comando TPM. Debe ser uno de los valores siguientes.

Valor	Significado
TBS_COMMAND_LOCALITY_ZERO 0 (0x0)	Localidad cero. Esta es la única localidad admitida actualmente.
TBS_COMMAND_LOCALITY_ONE 1 (0x1)	Localidad uno.
TBS_COMMAND_LOCALITY_TWO 2 (0x2)	Localidad dos.
TBS_COMMAND_LOCALITY_THREE 3 (0x3)	Localidad tres.
TBS_COMMAND_LOCALITY_FOUR 4 (0x4)	Localidad cuatro.

[in] Priority

Nivel de prioridad que debe tener el comando. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
TBS_COMMAND_PRIORITY_LOW 100 (0x64)	Se usa para el uso de aplicaciones de prioridad baja.
TBS_COMMAND_PRIORITY_NORMAL 200 (0xC8)	Se usa para el uso de la aplicación de prioridad normal.
TBS_COMMAND_PRIORITY_SYSTEM 400 (0x190)	Se usa para las tareas del sistema que acceden al TPM.
TBS_COMMAND_PRIORITY_HIGH 300 (0x12C)	Se usa para el uso de aplicaciones de alta prioridad.
TBS_COMMAND_PRIORITY_MAX 2147483648 (0x80000000)	Se usa para las tareas que se originan en el sistema de administración de energía.

[in] pabCommand

Puntero a un búfer que contiene el comando TPM que se va a procesar.

[in] cbCommand

Longitud, en bytes, del comando .

[out] pabResult

Puntero a un búfer para recibir el resultado del comando de TPM. Este búfer puede ser el mismo que pabCommand.

[in, out] pcbResult

Entero que, en la entrada, especifica el tamaño, en bytes, del búfer de resultados. Este valor se establece cuando se devuelve el comando submit. Si el búfer proporcionado es demasiado pequeño, este parámetro, en la salida, se establece en el tamaño necesario, en bytes, para el resultado.

Valor devuelto

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

Un comando se puede enviar correctamente y seguir produciendo un error en el TPM. En este caso, el código de error se devuelve como un error de TPM estándar en el búfer de resultados.

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 más valores de parámetro no son válidos.
TBS_E_BUFFER_TOO_LARGE 2150121486 (0x8028400E)	El búfer de entrada o salida es demasiado grande.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Error interno de software.
TBS_E_INSUFFICIENT_BUFFER 2150121477 (0x80284005)	El búfer de salida especificado es demasiado pequeño.
TBS_E_INVALID_CONTEXT 2150121476 (0x80284004)	El identificador de contexto especificado no hace referencia a un contexto válido.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Un puntero de salida especificado no es válido.
TBS_E_IOERROR 2150121478 (0x80284006)	Error al comunicarse con el 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