HrComposeMsgID

Aplica-se a: Outlook 2013 | Outlook 2016

Cria uma cadeia de caracteres ASCII que representa 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

HrComposeMsgID(
  LPMAPISESSION psession,
  ULONG cbStoreRecordKey,
  LPBYTE pStoreRecordKey,
  ULONG cbMsgEID,
  LPENTRYID pMsgEID,
  LPSTR FAR * pszMsgID
);

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 pszMsgID apontará para uma cópia do identificador de entrada convertido em texto.

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.

pszMsgID

[out] Ponteiro para a cadeia de caracteres ASCII retornada. Se o parâmetro cbStoreRecordKey for maior que zero, o parâmetro pszMsgID apontará para um identificador de entrada composto convertido em texto. Se cbStoreRecordKey for zero, pszMsgID apontará para um identificador de entrada não compatível convertido em texto.

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, a cadeia de caracteres do identificador será criada 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 parâmetro cbStoreRecordKey for zero, o identificador de entrada do objeto será simplesmente copiado e convertido em uma cadeia de caracteres.

Chamar a função HrComposeMsgID é equivalente a chamar a função HrComposeEID e, em seguida, a função HrSzFromEntryID .

O HrComposeMsgID permite que os aplicativos cliente trabalhem com objetos em vários repositórios por meio do uso de identificadores de entrada compostos. Um aplicativo pode chamar a função HrDecomposeMsgID para dividir o identificador de entrada composto em seus constituintes originais.