GetAttribIMsgOnIStg

Aplica-se a: Outlook 2013 | Outlook 2016

Recupera atributos de propriedades em um objeto IMessage fornecido pela função OpenIMsgOnIStg .

Propriedade	Valor
Arquivo de cabeçalho:	Imessage.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de repositório de mensagens

HRESULT GetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTagArray,
  LPSPropAttrArray FAR * lppPropAttrArray
);

Parâmetros

lpObject

[in] Ponteiro para um objeto IMessage obtido da função OpenIMsgOnIStg .

Lpproptagarray

[in] Ponteiro para uma estrutura SPropTagArray que contém uma matriz de marcas de propriedade indicando as propriedades para as quais os atributos devem ser recuperados.

lppPropAttrArray

[out] Ponteiro para um ponteiro para a estrutura SPropAttrArray retornada que contém os atributos de propriedade recuperados.

Valor de retorno

S_OK

A chamada foi bem-sucedida e retornou o valor ou valores esperados.

MAPI_W_ERRORS_RETURNED

A chamada foi bem-sucedida no geral, mas uma ou mais propriedades não puderam ser acessadas e foram retornadas com um tipo de propriedade de PT_ERROR.

Comentários

Os atributos de propriedade só podem ser acessados em objetos de propriedade, ou seja, objetos que implementam a interface IMAPIProp : IUnknown . Para disponibilizar propriedades MAPI em um objeto de armazenamento estruturado OLE, OpenIMsgOnIStg cria um objeto IMessage : IMAPIProp na parte superior do objeto OLE IStorage . Os atributos de propriedade nesses objetos podem ser definidos ou alterados com SetAttribIMsgOnIStg e recuperados com GetAttribIMsgOnIStg.

Observação

GetAttribIMsgOnIStg e SetAttribIMsgOnIStg não operam em todos os objetos IMessage . Eles são válidos apenas para objetos IMessage-on-IStorage retornados por OpenIMsgOnIStg.

O número e as posições dos atributos no parâmetro lppPropAttrArray correspondem ao número e às posições das marcas de propriedade no parâmetro lpPropTagArray .