SMTP_Bcc

4D Internet Commands v16

SMTP_Bcc


SMTP_Bcc ( smtp_ID ; copiaOculta {; excluirOpcao} ) -> Resultado

Parâmetro	Tipo	Descrição
smtp_ID	Inteiro longo	Referencia da mensagem
copiaOculta	Texto	Lista de endereços
excluirOpcao	Inteiro	0 = Adicionar, 1 = Substituir, 2 = Excluir
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_Bcc agrega destinatários em cópia oculta à mensagem especificada por smtp_ID. Não é obrigatório ter endereços no campo Cco:.

A única maneira de manter a confidencialidade da lista de endereços ao enviar um correio a um grupo de pessoas é inserir os endereços dentro da área de cabeçalhos "Cco". Os endereços listados neste cabeçalho não é enviado como parte do cabeçalho ou corpo da mensagem. Os endereços não poderão ser vistos por nenhum destinatário da mensagem.

Um destinatário "Cco" pode ver todos os destinatários em "Para" e "Cc", mas não os destinatários "Cco". Geralmente, durante o envio de um email massivo, todos os destinatários devem estar no cabeçalho "Cco". Isto evita que as mensagens recebidas tenham grandes listas de endereços saturando a mensagem e que os usuários acessem aos endereços dos demais.

Outra razão para o uso de "Cco" é que muitas aplicações de correio têm uma função "Responder a todos", que agrega todos os destinatários nas seções "Para" e "Cc" à mensagem de resposta. Colocar todas os endereços dos destinatários no cabeçalho "Cco" impedirá que os usuários respondam a todas as pessoas que receberam a mensagem original..

smtp_ID é a referencia inteiro longo de uma mensagem criada com o comando SMTP_New.

copiaOculta é um valor texto que contém uma ou mais emails.

excluirOpcao é um valor inteiro que especifica se deseja adicionar ou eliminar o cabeçalho "Bcc":

Um valor de zero, adiciona o novo valor ao campo "Bcc".
Se passar um valor de 1, o conteúdo do parâmetro passado será substituído o conteúdo do cabeçalho existente. Neste caso, se passa uma cadeia vazia em copiaOculta, o cabeçalho "Bcc" será eliminado.
Se passar 2, o cabeçalho "Bcc" é apagado da mensagem.
excluirOpcao é um parâmetro opcional que por padrão tem o valor zero.

Exemplo

Neste exemplo é criada uma mensagem e os elementos estáticos são definidos fora do alcance do laço 'for'. Depois, para cada registro na tabela [Pessoas], é agregado um endereço à lista de cópias ocultas.

 $error:=SMTP_From($smtp_id;"sales@massmarket.com")

 $error:=SMTP_Subject($smtp_id;"¡Ofertas incríveis! ¡Só esta semana!")

 $error:=SMTP_Body($smtp_id;$GenericBody)

 For($i;1;Records in selection([Pessoas]))

    $error:=SMTP_Bcc($smtp_id;[Pessoas]Email;0) `Adiciona este endereço de email à lista BCC

    NEXT RECORD([Pessoas])

 End for

 $error:=SMTP_Send($smtp_id) `Enviar a mensagem a todos

 $error:=SMTP_Clear($smtp_id)

Ver também

SMTP_Cc
SMTP_New