4D Doc Center : IMAP

4D Internet Commands v14

IMAP_SetCurrentMB


IMAP_SetCurrentMB ( imap_ID ; nomCaixaCorreio ; numMsg ; numNovaMsg ; listaMarc ; marcPermanente ; unicoIDB ) -> Resultado

Parâmetro	Tipo	Descrição
imap_ID	Inteiro longo	Referencia de conexão IMAP
nomCaixaCorreio	Texto	Nome da caixa de correio a selecionar
numMsg	Inteiro longo	Número de mensagens na caixa de correio especificado
numNovaMsg	Inteiro longo	Número de mensagens com o marcador \Recent
listaMarc	Texto	Lista de marcadores utilizados atualmente pela caixa de correio
marcPermanente	Texto	Lista de marcadores modificáveis
unicoIDB	Inteiro longo	Número de identificação único da caixa de correio especificada
Resultado	Inteiro	Código de erro

Descrição

O comando IMAP_SetCurrentMB permite abrir uma sessão (ou seja, selecionar a caixa de correio atual) para administrar as mensagens da caixa de correio especificada.

Só uma sessão pode ser aberta de uma só vez durante uma conexão, o acesso simultâneo a várias caixas de correio requerem múltiplas conexões (múltiplas IMAP_Login). O comando IMAP_SetCurrentMB fecha automaticamente a sessão atual antes de realizar a nova seleção. Portanto, se define uma caixa de correio como atual e a execução do comando IMAP_SetCurrentMB falha, não haverá caixa de correio atual.

Pode fechar uma sessão, (ou seja, fechar a caixa de correio atual) sem selecionar um novo, executando o comando IMAP_SetCurrentMB com um nomCaixaCorreio inexistente e durante a gestão de erros, executando IMAP_CloseCurrentMB ou IMAP_Logout.

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

nomCaixaCorreio é o nome completo de uma caixa de correio a definir como atual.

numMsg devolve o número de mensagens na caixa de correio atual (devolve -1 no caso de erro).

numNovaMsg devolve o número de mensagens recentes na caixa de correio atual (devolve -1 no caso de erro).

listaMarc devolve a lista completa de marcadores utilizados na caixa de correio atual. Leve em consideração que só os marcadores listados no parâmetro marcPermanente podem ser modificados.

marcPermanente devolve a lista de marcadores que podem ser modificados de forma permanente (com exceção do marcador \Recent, que é administrado pelo servidor IMAP). Note que a cadeia marcPermanente também pode incluir o marcador especial \*, o que significa que as palavras chaves podem ser criadas guardando os marcadores na caixa de correio (ver IMAP_SetFlags).

Se marcPermanente devolve uma cadeia vazia, isto significa que todos os marcadores listados no parâmetro listaMarc podem ser modificados.

unicoIDB devolve um identificador único da caixa de correio atual.
Este identificador pode ser particularmente útil se é eliminado uma caixa de correio e uma nova com o mesmo nome é criada em uma data posterior. Dado que o nome é o mesmo, só o número único permite ao cliente identificar a nova caixa de correio.