Chamadas de Funções Single-Thread da Lib TLS

Fonte: Chamadas de Métodos Lib TLS - GSURF

---

GSURF_ERRORSSL gsurf_init_ssl(char *appDataDir, char *uuid);

Descrição:\
Inicializa a biblioteca SSL. Retorna GSURF_ERRORSSL.

Parâmetros:

• char *appDataDir — Caminho do diretório de dados do aplicativo.
• char *uuid — UUID (identificador único) do dispositivo.

---

GSURF_ERRORSSL gsurf_connect_ssl(const char *serviceName, const char *host);

Descrição:\
Estabelece conexão SSL com o serviço desejado. Retorna GSURF_ERRORSSL.

Parâmetros:

• const char *serviceName — Nome do serviço (obtido com o comercial da GSurf). Se NULL, usa "default".
• const char *host — Endereço IP do host do Sitef Servidor via GW Local GSurf. Se NULL, conecta-se a um serviço hospedado.

---

GSURF_ERRORSSL gsurf_read_ssl(void *buffer, unsigned int bufferLength, int *bytesProcessed);

Descrição:\
Lê dados enviados pelo servidor. Retorna GSURF_ERRORSSL.

Parâmetros:

• void *buffer — Ponteiro para o início do buffer de leitura.
• unsigned int bufferLength — Tamanho do buffer de leitura.
• int *bytesProcessed — Ponteiro de saída com a quantidade de bytes lidos.

---

GSURF_ERRORSSL gsurf_write_ssl(void *buffer, unsigned int bufferLength, int *bytesProcessed);

Descrição:\
Envia dados para o servidor. Retorna GSURF_ERRORSSL.

Parâmetros:

• void *buffer — Ponteiro para o início do buffer a ser enviado.
• unsigned int bufferLength — Tamanho do buffer a ser enviado.
• int *bytesProcessed — Ponteiro de saída com a quantidade de bytes enviados.

---

GSURF_ERRORSSL gsurf_disconnect_ssl();

Descrição:\
Encerra a conexão SSL com o servidor. Retorna GSURF_ERRORSSL.

---

GSURF_ERRORSSL gsurf_install_certificate_ssl(char *activationKey, unsigned int activationKeyLength, char *otp, unsigned int otpLength);

Descrição:\
Instala o certificado no dispositivo. Retorna GSURF_ERRORSSL.

Parâmetros:

• char *activationKey — Chave de ativação.
• unsigned int activationKeyLength — Tamanho da string activationKey.
• char *otp — Token de instalação obtido com o comercial da GSurf.
• unsigned int otpLength — Tamanho da string otp.

---

void gsurf_free_ssl();

Descrição:\
Libera a memória alocada pela biblioteca GSurf.

---

void gsurf_set_cb_trace(GSURF_CB_TRACE cb_trace);

Descrição:\
Define o callback que será chamado para registro de logs. A configuração desse callback é opcional.

Parâmetros:

• GSURF_CB_TRACE cb_trace — Função de callback utilizada para registrar logs.

Assinatura da função de callback:

```c
void (GSURF_CB_TRACE)(const char title, int lenghtBuffer, const char *buffer);