Condividi tramite

funzione Tbsip_Submit_Command (tbs.h)

  • Articolo

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