4D Internet Commands v14

IMAP_SetCurrentMB

Página Inicial

 
4D Internet Commands v14
IMAP_SetCurrentMB

IMAP_SetCurrentMB 


 

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

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.

 
PROPRIEDADES 

Produto: 4D Internet Commands
Tema: IC IMAP Review Mail
Número 88878

 
HISTÓRIA 

Criado por: 4D Internet Commands 6.8.1

 
VER TAMBÉM 

IMAP_CloseCurrentMB
IMAP_GetFlags
IMAP_GetMBStatus
IMAP_ListMBs
IMAP_Logout
IMAP_SetFlags

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)