funzione Tbsip_Submit_Command (tbs.h)

Articolo
08/26/2023

Invia un comando TPM (Trusted Platform Module) a TPM Base Services (TBS) per l'elaborazione.

Sintassi

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
);

Parametri

[in] hContext

Handle del contesto che invia il comando.

[in] Locality

Usato per impostare la località per il comando TPM. Questo deve essere uno dei valori seguenti.

Valore	Significato
TBS_COMMAND_LOCALITY_ZERO 0 (0x0)	Localizzazione zero. Questa è l'unica località attualmente supportata.
TBS_COMMAND_LOCALITY_ONE 1 (0x1)	Localizzazione uno.
TBS_COMMAND_LOCALITY_TWO 2 (0x2)	Località due.
TBS_COMMAND_LOCALITY_THREE 3 (0x3)	Località tre.
TBS_COMMAND_LOCALITY_FOUR 4 (0x4)	Località quattro.

[in] Priority

Livello di priorità che deve avere il comando. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
TBS_COMMAND_PRIORITY_LOW 100 (0x64)	Usato per l'uso di applicazioni con priorità bassa.
TBS_COMMAND_PRIORITY_NORMAL 200 (0xC8)	Usato per l'uso normale dell'applicazione con priorità.
TBS_COMMAND_PRIORITY_SYSTEM 400 (0x190)	Usato per le attività di sistema che accedono al TPM.
TBS_COMMAND_PRIORITY_HIGH 300 (0x12C)	Usato per l'uso di applicazioni con priorità elevata.
TBS_COMMAND_PRIORITY_MAX 2147483648 (0x80000000)	Usato per le attività che provengono dal sistema di gestione energia.

[in] pabCommand

Puntatore a un buffer contenente il comando TPM da elaborare.

[in] cbCommand

Lunghezza, in byte, del comando.

[out] pabResult

Puntatore a un buffer per ricevere il risultato del comando TPM. Questo buffer può essere uguale a pabCommand.

[in, out] pcbResult

Intero che, in input, specifica le dimensioni, in byte, del buffer dei risultati. Questo valore viene impostato quando il comando submit restituisce. Se il buffer fornito è troppo piccolo, questo parametro, nell'output, viene impostato sulle dimensioni necessarie, in byte, per il risultato.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TBS_SUCCESS.

Un comando può essere inviato correttamente e non riesce ancora al TPM. In questo caso, il codice di errore viene restituito come errore TPM standard nel buffer dei risultati.

Se la funzione ha esito negativo, restituisce un codice restituito TBS che indica l'errore.

Codice/valore restituito	Descrizione
TBS_SUCCESS 0 (0x0)	La funzione ha avuto esito positivo.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Uno o più valori di parametro non sono validi.
TBS_E_BUFFER_TOO_LARGE 2150121486 (0x8028400E)	Il buffer di input o di output è troppo grande.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Si è verificato un errore interno del software.
TBS_E_INSUFFICIENT_BUFFER 2150121477 (0x80284005)	Il buffer di output specificato è troppo piccolo.
TBS_E_INVALID_CONTEXT 2150121476 (0x80284004)	L'handle di contesto specificato non fa riferimento a un contesto valido.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Un puntatore di output specificato non è valido.
TBS_E_IOERROR 2150121478 (0x80284006)	Si è verificato un errore durante la comunicazione con il TPM.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tbs.h
Libreria	Tbs.lib
DLL	Tbs.dll

Condividi tramite