4D Doc Center : IMAP

4D Internet Commands v14

IMAP_CreateMB


IMAP_CreateMB ( imap_ID ; nomCaixaCorreio ) -> Resultado

Parâmetro	Tipo	Descrição
imap_ID	Inteiro longo	Referencia de conexão IMAP
nomCaixaCorreio	Texto	Nome da caixa de correio criado
Resultado	Inteiro	Código de erro

Descrição

O comando IMAP_CreateMB cria uma caixa de correio com o nome dado. Se o separador de hierarquia do servidor IMAP aparece em outra parte no nome da caixa de correio, o servidor IMAP criará as caixas de correio pais necessários para a criação da caixa de correio especificada.

Por exemplo, se a criação da caixa "Projetos/IMAP/Doc" se solicita em um servidor na que "/" é o separador hierárquico:

Somente cria a caixa de correio "Doc" se "Projetos" e "IMAP" já existem.
As caixas de correio "IMAP" e "Doc" somente são criadas se "Projetos" já existe.
As caixas de correio "Projetos", "IMAP" e "Doc" são criados se não existem.

imap_ID é uma referencia inteiro longo a uma conexão aberta criada com IMAP_Login.

nomCaixaCorreio é o nome completo da caixa de correio a criar (ver as regras de nomes na introdução da seção IMAP).

Nota: A tentativa de criar uma caixa de correio chamada INBOX (que é um nome especial reservado que significa "caixa de correio principal para este usuário neste servidor") ou uma caixa de correio com um nome que se refere a uma caixa de correio existente, provocará um erro.