função Tbsip_Submit_Command (tbs.h)
Envia um comando TPM (Trusted Platform Module) para o TBS (Serviços Base do TPM) para processamento.
Sintaxe
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
O identificador do contexto que está enviando o comando.
[in] Locality
Usado para definir a localidade do comando TPM. Esse deve ser um dos valores a seguir.
[in] Priority
O nível de prioridade que o comando deve ter. Esse parâmetro pode usar um dos valores a seguir.
[in] pabCommand
Um ponteiro para um buffer que contém o comando TPM a ser processado.
[in] cbCommand
O comprimento, em bytes, do comando .
[out] pabResult
Um ponteiro para um buffer para receber o resultado do comando TPM. Esse buffer pode ser o mesmo que pabCommand.
[in, out] pcbResult
Um inteiro que, na entrada, especifica o tamanho, em bytes, do buffer de resultados. Esse valor é definido quando o comando submit retorna. Se o buffer fornecido for muito pequeno, esse parâmetro, na saída, será definido como o tamanho necessário, em bytes, para o resultado.
Retornar valor
Se a função for bem-sucedida, a função retornará TBS_SUCCESS.
Um comando pode ser enviado com êxito e ainda falhar no TPM. Nesse caso, o código de falha é retornado como um erro TPM padrão no buffer de resultados.
Se a função falhar, ela retornará um código de retorno de TBS que indica o erro.
Valor/código retornado | Descrição |
---|---|
|
A função foi bem-sucedida. |
|
Um ou mais valores de parâmetro não são válidos. |
|
O buffer de entrada ou saída é muito grande. |
|
Ocorreu um erro interno de software. |
|
O buffer de saída especificado é muito pequeno. |
|
O identificador de contexto especificado não se refere a um contexto válido. |
|
Um ponteiro de saída especificado não é válido. |
|
Ocorreu um erro durante a comunicação com o TPM. |
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | tbs.h |
Biblioteca | Tbs.lib |
DLL | Tbs.dll |