HrDecomposeEID

Aplica-se a: Outlook 2013 | Outlook 2016

Separa o identificador de entrada composto de um objeto, geralmente uma mensagem em um repositório de mensagens, no identificador de entrada desse objeto no repositório e no identificador de entrada do repositório.

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Implementado por:	MAPI
Chamado por:	Aplicativos do cliente

HrDecomposeEID(
  LPMAPISESSION psession,
  ULONG cbEID,
  LPENTRYID pEID,
  ULONG FAR * pcbStoreEID,
  LPENTRYID FAR * ppStoreEID,
  ULONG FAR * pcbMsgEID,
  LPENTRYID FAR * ppMsgEID
);

Parâmetros

psession

[in] Ponteiro para a sessão em uso pelo aplicativo cliente.

cbEID

[in] Tamanho, em bytes, do identificador de entrada composto a ser separado.

pEID

[in] Ponteiro para o identificador de entrada composto a ser separado.

pcbStoreEID

[out] Ponteiro para o tamanho retornado, em bytes, do identificador de entrada do repositório de mensagens que contém o objeto. Se o parâmetro pEID apontar para um identificador de entrada não compatível, o parâmetro pcbStoreEID apontará para um valor zero.

ppStoreEID

[out] Ponteiro para um ponteiro para o identificador de entrada retornado do repositório de mensagens que contém o objeto. Se o parâmetro pEID apontar para um identificador de entrada não compatível, NULL será retornado no parâmetro ppStoreEID .

pcbMsgEID

[out] Ponteiro para o tamanho retornado, em bytes, do identificador de entrada do objeto. Se o parâmetro pEID apontar para um identificador de entrada não compatível, o parâmetro pcbMsgEID será igual ao valor do parâmetro cbEID .

ppMsgEID

[out] Ponteiro para um ponteiro para o identificador de entrada retornado do objeto. Se o parâmetro pEID apontar para um identificador de entrada não compatível, ppMsgEID apontará para um ponteiro para uma cópia do identificador de entrada não compatível.

Valor de retorno

Nenhum.

Comentários

Se o identificador especificado pelo parâmetro pEID for composto, ele será dividido no identificador de entrada do objeto em seu repositório de mensagens e no identificador de entrada do repositório. Cadeias de caracteres de identificador de entrada não compatíveis são simplesmente copiadas. O identificador composto a ser separado geralmente é um criado pela função HrComposeEID .

Notas para chamadores

A memória que contém o parâmetro pEID é liberada após a conclusão bem-sucedida dessa função. A implementação de chamada é responsável por liberar memória para os parâmetros de saída.