hook_param

Comportamento

C

• Busca o valor de um parâmetro nomeado especificado em read_ptr
• Escreve o valor do parâmetro em write_ptr

JavaScript

• Recupera o valor de um parâmetro associado à chave especificada.
• Retorna o valor associado à chave, ou um código de erro se a recuperação falhar.

Definição

C

int64_t hook_param (
    uint32_t write_ptr,
    uint32_t write_len,
    uint32_t read_ptr,
    uint32_t read_len
);

JavaScript

function hook_param(key: ByteArray | HexString): ErrorCode | ByteArray

Exemplo

C

uint8_t pname[] = {0xCAU, 0xFEU};
uint8_t pvalue[32];
int64_t value_len =
    hook_param(pvalue, 32, pname, 2);

JavaScript

const pname = [0xCA, 0xFE]
const pvalue = hook_param(pname)

Parâmetros

C

Nome	Tipo	Descrição
write_ptr	uint32_t	Ponteiro para um buffer de tamanho adequado para armazenar a saída. Deve ter pelo menos 32 bytes.
write_len	uint32_t	Tamanho do buffer de saída.
read_ptr	uint32_t	Ponteiro para um buffer contendo o nome do parâmetro
read_len	uint32_t	Tamanho do nome do parâmetro

JavaScript

Nome	Tipo	Descrição
key	ByteArray ou HexString	A chave para a qual recuperar o valor do parâmetro.

Código de Retorno

C

Tipo	Descrição
int64_t	O número de bytes escritos Se negativo, um erro: OUT_OF_BOUNDS - ponteiros/tamanhos especificados fora da memória do hook. DOESNT_EXIST - O parâmetro especificado não existe ou é nulo TOO_SMALL - O nome do parâmetro não pode ser nulo TOO_BIG - O nome do parâmetro é maior que 32 bytes

JavaScript

Tipo	Descrição
ByteArray ou ErrorCode	Retorna o valor associado à chave, ou um código de erro se a recuperação falhar.