WrapStoreEntryID

Aplica-se a: Outlook 2013 | Outlook 2016

Converte o identificador de entrada interna de um repositório de mensagens em um identificador de entrada mais utilizável pelo sistema de mensagens.

Propriedade	Valor
Arquivo de cabeçalho:	Mapidefs.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de serviços

WrapStoreEntryID(
  ULONG ulFlags,
  LPSTR szDLLName,
  ULONG cbOrigEntry,
  LPENTRYID lpOrigEntry,
  ULONG * lpcbWrappedEntry,
  LPENTRYID * lppWrappedEntry
);

Parâmetros

ulFlags

[in] Máscara de bits de sinalizadores. O seguinte sinalizador pode ser definido:

MAPI_UNICODE

As cadeias de caracteres estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.

szDLLName

[in] O nome da DLL do provedor do repositório de mensagens.

cbOrigEntry

[in] Tamanho, em bytes, do identificador de entrada original para o repositório de mensagens.

lpOrigEntry

[in] Ponteiro para uma estrutura ENTRYID que contém o identificador de entrada original.

lpcbWrappedEntry

[out] Ponteiro para o tamanho, em bytes, do novo identificador de entrada.

lppWrappedEntry

[out] Ponteiro para um ponteiro para uma estrutura ENTRYID que contém o novo identificador de entrada.

Valor de retorno

Nenhum.

Comentários

Um objeto do repositório de mensagens mantém um identificador de entrada interno que é significativo apenas para provedores de serviços coresident com esse repositório de mensagens. Para outros componentes de mensagens, o MAPI fornece uma versão encapsulada do identificador de entrada interna que o torna reconhecível, pois pertence ao repositório de mensagens. Os provedores de serviços coresident devem sempre receber o identificador de entrada do repositório de mensagens desembrulhado original; os aplicativos cliente devem sempre receber a versão encapsulada, que é utilizável em qualquer lugar no domínio de mensagens e em outros domínios.

Um provedor de serviços pode envolver um identificador de entrada do repositório de mensagens usando a função WrapStoreEntryID ou o método IMAPISupport::WrapStoreEntryID , que chama a função WrapStoreEntryID . O provedor deve envolver o identificador de entrada ao expor a propriedade PR_ENTRYID (PidTagEntryId) do repositório de mensagens ou escrevê-la em uma seção de perfil e ao expor a propriedade PR_STORE_ENTRYID (PidTagStoreEntryId). O MAPI envolve um identificador de entrada do repositório de mensagens ao responder a uma chamada IMAPISession::OpenMsgStore .

Quando um aplicativo cliente passa um identificador de entrada do repositório de mensagens encapsulado para MAPI, por exemplo, em uma chamada IMAPISession::OpenEntry , MAPI desembrulha o identificador de entrada antes de usá-lo para chamar um método de provedor como IMSProvider::Logon ou IMSProvider::CompareStoreIDs.