HrDecomposeMsgID

Aplica-se a: Outlook 2013 | Outlook 2016

Separa a representação ASCII do 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

HrDecomposeMsgID(
  LPMAPISESSION psession,
  LPSTR szMsgID,
  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.

szMsgID

[in] A cadeia de caracteres que representa o identificador de entrada do objeto.

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 szMsgID apontar para uma cadeia de caracteres de identificador de entrada não compatível, o parâmetro pcbStoreEID aponta para 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 szMsgID 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 em seu repositório. Se o parâmetro szMsgID apontar para uma cadeia de caracteres de 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 a cadeia de caracteres identificador de entrada retornada do objeto em seu repositório. Se o parâmetro szMsgID apontar para um identificador de entrada não compatível, ppMsgEID apontará para um ponteiro para uma cópia convertida do identificador de entrada não compatível.

Valor de retorno

Nenhum.

Comentários

Se o identificador especificado pelo parâmetro szMsgID for composto, ele será convertido do ASCII e dividido no identificador de entrada do objeto dentro do repositório de mensagens e do identificador de entrada do repositório. Cadeias de caracteres de identificador de entrada não compatíveis são simplesmente convertidas e copiadas. A cadeia de caracteres do identificador composto a ser separada geralmente é uma criada pela função HrComposeMsgID .

Chamar a função HrDecomposeMsgID é equivalente a chamar a função HrEntryIDFromSz e, em seguida, a função HrDecomposeEID .