Formato dos parâmetros

As descrições a continuação oferecem detalhes sobre o significado e o formato dos parâmetros mais utilizados neste manual.

O parâmetro nomeServidor é o nome ou o endereço IP do servidor local (HostName), por exemplo "dns.4d.com" ou "204.118.90.2". Os nomes de servidores se convertem por meio de um sistema de nomes de domínio. Os nomes de domínios por padrão (primários) e secundários  normalmente se definem no painel de controle do driver TCP/IP instalado. Todo comando de Internet 4D necessita um nomeServidor como parâmetro aceitando seu nome ("www.4d.com") ou seu endereço IP ("204.118.90.2") . O formato "nome" sempre é preferível, já que protege a aplicação de efeitos nocivos devidos as mudanças de hardware em lugares remotos.

Os nomes dos servidores podem se resolver via os métodos descritos anteriormente aplicados a um endereço IP. As fórmulas matemáticas podem então se aplicar aos endereços IP para converter eles em inteiros longos únicos. Os comandos NET_NameToAddr e NET_AddrToName automatizam esta conversão. Este valor inteiro longo é designado como ip_InteiroLongo nesta documentação. Este valor só é utilizado em circunstâncias especiais pelos desenvolvedores que estabelecem comunicação TCP direta. Alguns desenvolvedores também preferem armazenar o valor inteiro longo de um nome de domínio para conservar o espaço em disco comparado com sua cadeia equivalente. No entanto, por razões de compatibilidade com IPV6, 4D não aconselha aos desenvolvedores utilizar esta funcionalidade.

O parâmetro endereçoEmail é uma especificação completa de email no formato "nome_usuario@nome_dominio". Neste documento, endereçoEmail se refere a um só endereço de correio eletrônico. Todo parâmetro 4D Internet Commands que possa tomar mais de um endereço especificará endereçoEmail. Se um parâmetro tem endereçoEmail como seu único tipo, pode tomar um e só um endereço de correio eletrônico. O formato de endereçoEmail deve ser uma referencia completa que contenha tanto o nome de usuário e como o nome de domínio:

• "Felix Unger" <felix@pristine.com>

• oscar@slobs.com (Oscar Madison)

O parâmetro listaEndereços contém um ou mais endereços eletrônicos no formato de endereçoEmail, separadas por vírgula ou um retorno de carro. A delimitação por retorno de carro é útil para oferecer aos usuários uma área de texto que permita introduzir ou colar vários endereços. Os seguintes três exemplos geram um valor $listaEndereços válido:

O parâmetro viaLocal indica a localização de um arquivo ou de um diretório no ordenador do usuário (Mac ou Windows).

Em um Macintosh, os elementos ao interior das pastas estão separados pelos caracteres "dois pontos" (:). Por exemplo, o arquivo "Meu relatório" na pasta "Relatórios" no disco duro "Meu disco duro" será como via de acesso "Meu disco duro:Relatórios:Meu relatório". Uma especificação de diretório em um Macintosh deve terminar com um caractere "dois pontos". Por exemplo, se quer colocar um novo relatório na pasta indicada anteriormente, deve passar a cadeia "Meu disco duro:Relatórios:". A decisão de fazer referencia a um nome de arquivo ou de diretório está relacionada com o contexto do comando.

Em Windows, o princípio utilizado é idêntico, a exceção de que uma barra oblíqua inversa "\" se utiliza no lugar de "dois pontos".

Nota: Com o protocolo FTP, os comandos Internet de 4D não permitem trabalhar com arquivos cujo nomes tem mais de 31 caracteres (ver Transferência de arquivos, Apresentação ).

A viaServidor é a localização de um arquivo ou de um diretório em um ordenador que funciona sob o sistema operativo Unix. No entorno Unix, os diretórios estão separados por barras oblíquas ("/"). Por exemplo, o arquivo "relatório.txt" no diretório "relatórios" do diretório "4D" será designado por "/4D/relatórios/relatório.txt". A via de acesso de um diretório deve terminar com um caractere "/". Note que uma via de acesso completa começa por uma barra oblíqua "/" que representa a raiz do volume.

Nota: com o protocolo FTP, os comandos Internet de 4D trabalham com arquivos cujos nomes tem um tamanho limitado. Para mais informação, consulte a seção Transferência de arquivos, Apresentação ).

Ao longo de cada seção de 4D Internet Commands, se faz referencia a um número "ID" na maioria dos comandos. Cada conjunto de funções de comunicação estabelecerão sua própria "sessão", representada por um número inteiro longo "ID". Os comandos posteriores relacionados com a sessão aberta usarão este valor para dirigir seus efeitos pelo canal adequado.

Os números "ID" obtidos em cada seção (SMTP, POP3, IMAP, FTP, TCP, UDP), não podem passar como valores as diferentes seções. No entanto, para maior flexibilidade, 4D Internet Commands lhe permite passar uma referencia de conexão POP3, IMAP ou FTP diretamente a comandos TCP de baixo nível e vice-versa. Para obter mais informação, consulte a seção Low Level Routines, Overview.

Todos os comandos de Internet  4D (com exceção de IT_ErrorText e IT_Version) devolvem um valor inteiro como resultado da função. Este inteiro contém todo número de erro que o comando deva transmitir de novo ao banco de dados 4D. Se um comando se executa corretamente, se devolve um zero. Caso contrário, se devolve um código de erro. Para obter mais informação sobre os códigos de erro de 4D Internet Commands, consulte Apêndice C, Códigos de erro de 4D Internet Commands.