TsgcTCPClient › Métodos › Connect

Connect Method

Abre a conexão TCP de forma síncrona e bloqueia o chamador até que o socket seja conectado ou o timeout expire.

Sintaxe

function Connect(const aTimeout: Integer = 10000): Boolean;

Parâmetros

NameTypeDescrição
aTimeoutconst IntegerTempo máximo em milissegundos para aguardar até que a conexão se torne ativa. O padrão é 10000 (10 segundos).

Valor de retorno

True quando o socket TCP foi estabelecido dentro do timeout; False caso contrário. (Boolean)

Observações

Connect é a contraparte bloqueante de definir Active := True. Ele define Active internamente e então aguarda em um evento interno até que o handshake TCP seja concluído ou o timeout expire. Diferentemente do cliente WebSocket, não há etapa de upgrade HTTP, portanto o método retorna assim que o socket bruto (e a negociação TLS, quando habilitada) é estabelecido. Se o cliente já estiver conectado, o método retorna True imediatamente. Quando a função retorna True é seguro chamar WriteData imediatamente, sem aguardar por OnConnect. Use Start em vez disso se você precisar de uma chamada não bloqueante que conecta a partir de uma thread secundária.

Exemplo


oClient := TsgcTCPClient.Create(nil);
oClient.Host := '127.0.0.1';
oClient.Port := 5000;
if oClient.Connect(5000) then
  oClient.WriteData('Hello Server')
else
  ShowMessage('Connection failed');

Voltar para Métodos