HrComposeEID
Aplica-se a: Outlook 2013 | Outlook 2016
Cria um identificador de entrada composto para um objeto, geralmente uma mensagem em um repositório de mensagens.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Chamado por: |
Aplicativos do cliente |
HrComposeEID(
LPMAPISESSION psession,
ULONG cbStoreRecordKey,
LPBYTE pStoreRecordKey,
ULONG cbMsgEID,
LPENTRYID pMsgEID,
ULONG FAR * pcbEID,
LPENTRYID FAR * ppEID
);
Parâmetros
psession
[in] Ponteiro para a sessão em uso pelo aplicativo cliente.
cbStoreRecordKey
[in] Tamanho, em bytes, da chave de registro do repositório de mensagens que contém a mensagem ou outro objeto. Se zero for passado no parâmetro cbStoreRecordKey , o parâmetro ppEID apontará para uma cópia do identificador de entrada do objeto.
pStoreRecordKey
[in] Ponteiro para a chave de registro do repositório de mensagens que contém a mensagem ou outro objeto.
cbMsgEID
[in] Tamanho, em bytes, do identificador de entrada da mensagem ou de outro objeto.
pMsgEID
[in] Ponteiro para o identificador de entrada do objeto.
pcbEID
[out] Ponteiro para o tamanho, em bytes, do identificador retornado.
ppEID
[out] Ponteiro para um ponteiro para o identificador de entrada retornado. Se o valor do parâmetro cbStoreRecordKey for maior que zero, o parâmetro ppEID apontará para um ponteiro para o identificador de entrada composto criado. Se cbStoreRecordKey for zero, ppEID apontará para um ponteiro para uma cópia do identificador de entrada do objeto.
Valor de retorno
Nenhum.
Comentários
Se a mensagem ou outro objeto para o qual o identificador de entrada composto estiver sendo criado residir em um repositório de mensagens, o identificador será criado a partir do identificador de entrada do objeto e da chave de registro do repositório. Se o objeto não estiver em um repositório, ou seja, se a contagem de bytes da chave de registro do repositório passada no cbStoreRecordKey for zero, o identificador de entrada do objeto será simplesmente copiado.
A função HrComposeEID permite que os aplicativos trabalhem com objetos em vários repositórios por meio do uso de identificadores de entrada compostos. Um aplicativo pode chamar a função HrDecomposeEID para dividir o identificador de entrada composto em seus constituintes originais.