ENTRYID

9/8/2008

The EntryID estrutura encapsula um identificador entrada para um objeto MAPI.

Syntax

struct {
  BYTE abFlags[4];
  BYTE ab[MAPI_DIM];
} ENTRYID, FAR *LPENTRYID;

Members

• abFlags
  Máscara de bits de sinalizadores que fornecem informações que descrevem o objeto. Somente o primeiro byte dos sinalizadores, abFlags [0], pode ser definido, o provedor; Os outros três são reservados. Esses sinalizadores não devem ser definidos para identificadores entrada permanente; Eles são definidos somente para identificadores entrada de curto prazo. Aos clientes, essa estrutura é somente leitura.

  O seguinte sinalizadores podem ser definidos no abFlags [0]:

  • MAPI_NOTRECIP
    O identificador entrada não pode ser usado como um destinatário em uma mensagem.
  • MAPI_NOTRESERVED
    Outros usuários não pode acessar o identificador entrada.
  • MAPI_NOW
    O identificador entrada não pode ser usado em outros momentos.
  • MAPI_SHORTTERM
    O identificador entrada é a curto prazo. Todos os outros valores neste byte devem ser definidos, a menos que outros usos do identificador de entrada são permitidos.
  • MAPI_THISSESSION
    O identificador entrada não pode ser usado em outras sessões.

• Ab
  Indica uma matriz de dados binários usado pelo serviço provedores. O aplicativo cliente não é possível usar essa matriz.

Remarks

The EntryID estrutura é usada por mensagem provedores para armazenar e endereço de catálogo exclusivo construção identificadores para os seus objetos. Identificadores de entrada são usados para identificar o seguinte objeto tipos:

• Armazenar mensagens
• Pasta
• Mensagem
• Contêiner de Catálogo de endereços
• Lista de distribuição
• Usuário de mensagens
• Status
• Seção de Perfil

Cada provedor usa um formato para o EntryID estrutura que faz sentido para esse provedor.

Identificadores de entrada não podem ser comparados diretamente como um objeto pode ser representado por dois binário diferentes valores. Para determinar se dois identificadores entrada representam o mesmo objeto, chamar o método IMAPISession::CompareEntryIDs.

Quando um cliente chama IMAPIProp::GetProps método de um objeto para recuperar seu identificador entrada, o objeto retorna a forma mais permanente de identificador de entrada. Um cliente pode verificar que um identificador entrada é a longo prazo, verificando que nenhuma dos sinalizadores são definidas no primeiro byte das abFlags membro.

Quando um cliente acessa um identificador entrada por uma coluna em uma tabela, provavelmente esse identificador entrada é a curto prazo em vez de longo prazo. Identificadores de curto prazo entrada podem ser usados para aberto seus correspondente objetos apenas na atual sessão MAPI. Um cliente pode verificar que um identificador entrada é a curto prazo, verificando que todos os sinalizadores são definidos no primeiro byte de abFlags.

Alguns identificadores entrada são a curto prazo mas tem o uso de longo prazo. Esses identificadores entrada ter um ou mais do apropriado sinalizadores definido no primeiro byte de abFlags.

Um EntryID estrutura tem a seguinte características:

• Não armazenar o tamanho do identificador de entrada.
• Armazena os dados sinalizador e o resto do identificador de entrada separadamente.
• É passado como um parâmetro para os métodos de interface de IMAPIProp e a seguinte OpenEntry métodos:
  • IMAPIContainer::OpenEntry
  • IMAPISession::OpenEntry
  • IMsgStore::OpenEntry
• É usado para armazenar um identificador entrada no disco.

Os clientes devem sempre transmitir na entrada naturalmente alinhado identificadores. Embora os provedores devem identificador arbitrariamente alinhado identificadores entrada, os clientes não devem esperar esse comportamento. Falha ao transmitir um identificador entrada alinhado adequado para um método pode resultar em uma falha alinhamento em processadores RISC.

O fator alinhamento natural, 8 bytes, geralmente é o maior tipo de dados com suporte pela CPU e é normalmente o mesmo fator alinhamento usado pelo alocador memória de sistema. Um endereço naturalmente alinhado memória permite o CPU para acessar qualquer tipo de dados ele oferece suporte a esse endereço sem gerar uma falha alinhamento. Para CPUs RISC, um tipo de dados de tamanho n Bytes geralmente devem ser alinhados em um múltiplo par do n bytes, com o endereço seja um múltiplo par do n.

O uso

O seguinte APIs levar parâmetros, ou incluir como membros, que são os ponteiros de tipo LPENTRYID (ponteiros para EntryID variáveis).

Termo	Definição
ERROR_NOTIFICATION	The ERROR_NOTIFICATION estrutura descreve informações relacionadas a um crítico Erro, causando uma notificação de erro seja gerado.
ICEMAPISession::DeleteMsgStore	The DeleteMsgStore método exclui armazenar a mensagem a armazenar MAPI.
IFormProvider::GetMsgStatusIconIndex	The GetMsgStatusIconIndex método retorna o índice para o apropriado ícone no bitmap de símbolo para a biblioteca forma.
IFormProviderEx::GetMsgStatusIconIndex	The GetMsgStatusIconIndex método retorna o índice para o apropriado ícone no bitmap de símbolo para a biblioteca forma.
IMailRuleClient::ProcessMessage	The ProcessMessage método processa de entrada mensagens, que podem ser movidas, modificados ou excluídos.
IMAPIContainer::OpenEntry	The OpenEntry método abre um objeto dentro de contêiner, retornando um ponteiro interface para acessar mais.
IMAPIFolder::CopyFolder	The CopyFolder método Move uma subpasta. Copiar uma subpasta não com suporte em Windows Mobile powered Mensagens.
IMAPIFolder::DeleteFolder	The DeleteFolder método Remove uma subpasta a atual pasta.
IMAPISession::Advise	The Avisar método registra para receber notificação de eventos especificados afetando a sessão.
IMAPISession::CompareEntryIDs	The CompareEntryIDs método compara dois identificadores entrada para determinar se eles referir para o mesmo objeto.
IMAPISession::OpenEntry	The OpenEntry método abre um objeto e retorna um ponteiro interface para acessar mais.
IMAPISession::OpenMsgStore	The OpenMsgStore método abre armazenar uma mensagem e retorna uma referência para o objeto IMsgStore para acessar mais.
IMessageFormEx::OnMessageModified	The OnMessageModified método notifica a forma mensagem quando uma mensagem objeto alterado.
IMsgStore::Advise	The Avisar método registra para receber notificação de eventos especificados afetar armazenar a mensagem.
IMsgStore::GetReceiveFolder	The GetReceiveFolder método obtém a pasta que foi estabelecida como o destino para de entrada receber mensagens de uma classe mensagem especificado ou o usar como padrão pasta para armazenar a mensagem.
IMsgStore::OpenEntry	The OpenEntry método abre um objeto armazenar mensagem e retorna um ponteiro interface para acessar mais.
MailDisplayMessage	The MailDisplayMessage função exibe uma mensagem existente.
MailSwitchToFolder	The MailSwitchToFolder função alterna para uma pasta e exibe seu conteúdo em um modo de exibição de lista.
MAILSYNCREQUEST	The MAILSYNCREQUEST estrutura descreve a solicitação de sincronização feita pelo aplicativo de email para o transporte.
NEWMAIL_NOTIFICATION	The NEWMAIL_NOTIFICATION estrutura descreve informações relacionadas à chegada de uma nova mensagem.
OBJECT_NOTIFICATION	The OBJECT_NOTIFICATION estrutura contém informações sobre um objeto que tenha sofrido uma alteração, such as sendo copiado ou modificado.
SizedENTRYID	The SizedENTRYID macro cria um nomeado EntryID estrutura que contém um membro AB de um tamanho especificado.
STATUS_OBJECT_NOTIFICATION	The STATUS_OBJECT_NOTIFICATION estrutura descreve um objeto status que tenha sido afetado por uma alteração.
SYNCPROGRESSITEM	The SYNCPROGRESSITEM estrutura descreve as informações de andamento relatadas pelo transporte para transmissão de mensagens.

Requirements

Header	mapidefs.h
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

Macros relacionadas

CbNewENTRYID | SizedENTRYID

See Also

Reference

MAPI Structures

Other Resources

Messaging