Compartir a través de

función Tbsip_Submit_Command (tbs.h)

  • Artículo

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