GetAttribIMsgOnIStg

Hace referencia a: Outlook 2013 | Outlook 2016

Recupera atributos de propiedades en un objeto IMessage proporcionado por la función OpenIMsgOnIStg .

Propiedad	Valor
Archivo de encabezado:	Imessage.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de almacén de mensajes

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

Parameters

lpObject

[in] Puntero a un objeto IMessage obtenido de la función OpenIMsgOnIStg .

lpPropTagArray

[in] Puntero a una estructura SPropTagArray que contiene una matriz de etiquetas de propiedad que indica las propiedades para las que se van a recuperar los atributos.

lppPropAttrArray

[out] Puntero a un puntero a la estructura SPropAttrArray devuelta que contiene los atributos de propiedad recuperados.

Valor devuelto

S_OK

La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.

MAPI_W_ERRORS_RETURNED

La llamada se realizó correctamente en general, pero no se pudo acceder a una o varias propiedades y se devolvieron con un tipo de propiedad de PT_ERROR.

Comentarios

Solo se puede tener acceso a los atributos de propiedad en objetos de propiedad, es decir, objetos que implementan la interfaz IMAPIProp : IUnknown . Para que las propiedades MAPI estén disponibles en un objeto de almacenamiento estructurado OLE, OpenIMsgOnIStg compila un objeto IMessage : IMAPIProp sobre el objeto OLE IStorage . Los atributos de propiedad de estos objetos se pueden establecer o modificar con SetAttribIMsgOnIStg y recuperarse con GetAttribIMsgOnIStg.

Nota:

GetAttribIMsgOnIStg y SetAttribIMsgOnIStg no funcionan en todos los objetos IMessage . Solo son válidos para los objetos IMessage-on-IStorage devueltos por OpenIMsgOnIStg.

El número y las posiciones de los atributos del parámetro lppPropAttrArray corresponden al número y las posiciones de las etiquetas de propiedad en el parámetro lpPropTagArray .