accept

Conceitos

Introdução Metadados de Execução

Comportamento

Encerra a execução do hook com status: sucesso.

• Registra uma string de retorno e um código de retorno nos metadados da transação.
• Confirma todas as alterações de estado.
• Envia todas as transações emit().
• Permite que a transação de origem continue.

Cuidado

Se a transação de origem for interrompida por algum outro motivo, este accept se torna um rollback. Veja: Ordem de Execução.

Definição

C

int64_t accept (
    uint32_t read_ptr,
    uint32_t read_len,
    uint64_t error_code
);

JavaScript

function accept(msg: string, code: number): number

Exemplo

C

accept("Sucesso", 7, 100);

JavaScript

accept('Sucesso', 100)

Parâmetros

C

Nome	Tipo	Descrição
read_ptr	uint32_t	Ponteiro para uma string de retorno a ser armazenada nos metadados de execução. Esta é qualquer string que o desenvolvedor do hook desejar retornar com a aceitação. Pode ser nulo.
read_len	uint32_t	O tamanho da string de retorno. No máximo 32. Pode ser nulo.
error_code	uint64_t	Um código de retorno específico deste hook a ser armazenado nos metadados de execução. Semelhante ao código de retorno de uma aplicação em um sistema *nix. Por convenção, sucesso é zero.

JavaScript

Nome	Tipo	Descrição
msg	string	String a ser armazenada nos metadados de execução. Esta é qualquer string que o desenvolvedor do hook desejar retornar com a aceitação. Pode ser nulo.
code	number	Um código de retorno específico deste hook a ser armazenado nos metadados de execução. Semelhante ao código de retorno de uma aplicação em um sistema *nix. Por convenção, sucesso é zero.

Código de Retorno

C

Tipo	Descrição
int64_t	Accept encerra o hook, portanto nenhum valor é retornado ao chamador. Por convenção, todas as APIs de Hook retornam int64_t, mas neste caso nada é retornado.

JavaScript

Tipo	Descrição
number	Accept encerra o hook, portanto nenhum valor é retornado ao chamador. Por convenção, todas as APIs de Hook retornam number, mas neste caso nada é retornado.