SetAttribIMsgOnIStg

Aplica-se a: Outlook 2013 | Outlook 2016

Define ou altera atributos de propriedades num objeto IMessage fornecido pela função OpenIMsgOnIStg .

Propriedade	Valor
Arquivo de cabeçalho:	Imessage.h
Implementado por:	MAPI
Chamado por:	Aplicações cliente e fornecedores de arquivo de mensagens

HRESULT SetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTags,
  LPSPropAttrArray lpPropAttrs,
  LPSPropProblemArray FAR * lppPropProblems
);

Parâmetros

lpObject

[in] Ponteiro para o objeto para o qual os atributos de propriedade estão a ser definidos.

lpPropTags

[in] Ponteiro para uma estrutura SPropTagArray que contém uma matriz de etiquetas de propriedade que indicam as propriedades para as quais os atributos de propriedade estão a ser definidos.

lpPropAttrs

[in] Ponteiro para uma estrutura SPropAttrArray que lista os atributos de propriedade a definir.

lppPropProblems

[fora] Ponteiro para a estrutura SPropProblemArray devolvida que contém um conjunto de problemas de propriedade. Esta estrutura identifica os problemas encontrados se SetAttribIMsgOnIStg tiver sido capaz de definir algumas propriedades, mas não todas. Se for transmitido um ponteiro para NULL no parâmetro lppPropProblems , não é devolvida nenhuma matriz de problema de propriedade, mesmo que algumas propriedades não tenham sido definidas.

Valor de retorno

S_OK

A chamada foi efetuada com êxito e devolveu o valor ou valores esperados.

MAPI_W_ERRORS_RETURNED

A chamada foi efetuada com êxito geral, mas não foi possível aceder a uma ou mais propriedades e foi devolvida com um tipo de propriedade de PT_ERROR.

Comentários

Os atributos de propriedade só podem ser acedidos em objetos de propriedade, ou seja, objetos que implementam a interface IMAPIProp : IUnknown . Para disponibilizar as propriedades MAPI num objeto de armazenamento estruturado OLE, o OpenIMsgOnIStg cria um objeto IMessage: IMAPIProp sobre o objeto OLE IStorage . Os atributos de propriedade nesses objetos podem ser definidos ou alterados com SetAttribIMsgOnIStg e obtidos com GetAttribIMsgOnIStg.

NotaGetAttribIMsgOnIStg e SetAttribIMsgOnIStg não funcionam em todos os objetos IMessage . Só são válidos para objetos IMessage-on-IStorage devolvidos por OpenIMsgOnIStg.

No parâmetro lpPropAttrs , o número e a posição dos atributos têm de corresponder ao número e posição das etiquetas de propriedade transmitidas no parâmetro lpPropTags .

A função SetAttribIMsgOnIStg é utilizada para tornar as propriedades da mensagem só de leitura quando necessário pelo esquema IMessage . O fornecedor de arquivo de mensagens de exemplo utiliza-o para esta finalidade. Para obter mais informações, consulte Mensagens.