IMAPISupport::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 no formato padrão MAPI.
HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);
Parâmetros
cbOrigEntry
[in] A contagem de bytes no identificador de entrada apontada pelo parâmetro lpOrigEntry .
lpOrigEntry
[in] Um ponteiro para o identificador de entrada privada para o repositório de mensagens.
lpcbWrappedEntry
[out] Um ponteiro para a contagem de bytes no identificador de entrada apontado pelo parâmetro lppWrappedEntry .
lppWrappedEntry
[out] Um ponteiro para um ponteiro para o identificador de entrada encapsulado.
Valor de retorno
S_OK
O identificador de entrada foi embrulhado com êxito.
Comentários
O método IMAPISupport::WrapStoreEntryID é implementado para todos os objetos de suporte do provedor de serviços. Os provedores de serviço usam WrapStoreEntryID para que o MAPI gere um identificador de entrada para um repositório de mensagens que envolve o identificador de entrada interna do repositório.
Notas para chamadores
Quando um cliente chama o método IMAPIProp::GetProps do seu repositório de mensagens para recuperar sua propriedade PR_STORE_ENTRYID (PidTagStoreEntryId) e seu repositório de mensagens usa um identificador de entrada em um formato privado, chame WrapStoreEntryID e retorne o identificador de entrada apontado pelo parâmetro lppWrappedEntry .
Chamadas para os métodos IMSProvider::Logon e IMSLogon::CompareEntryIDs sempre obtêm o identificador de entrada privada do repositório; a versão encapsulada é usada apenas entre aplicativos cliente e MAPI.
Libere a memória para o identificador de entrada apontado pelo parâmetro lppWrappedEntry usando a função MAPIFreeBuffer quando terminar de usar o identificador de entrada.