SetAttribIMsgOnIStg
Hace referencia a: Outlook 2013 | Outlook 2016
Establece o modifica 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 SetAttribIMsgOnIStg(
LPVOID lpObject,
LPSPropTagArray lpPropTags,
LPSPropAttrArray lpPropAttrs,
LPSPropProblemArray FAR * lppPropProblems
);
Parameters
lpObject
[in] Puntero al objeto para el que se establecen los atributos de propiedad.
lpPropTags
[in] Puntero a una estructura SPropTagArray que contiene una matriz de etiquetas de propiedad que indica las propiedades para las que se establecen los atributos de propiedad.
lpPropAttrs
[in] Puntero a una estructura SPropAttrArray que enumera los atributos de propiedad que se van a establecer.
lppPropProblems
[out] Puntero a la estructura SPropProblemArray devuelta que contiene un conjunto de problemas de propiedad. Esta estructura identifica los problemas detectados si SetAttribIMsgOnIStg ha podido establecer algunas propiedades, pero no todas. Si se pasa un puntero a NULL en el parámetro lppPropProblems , no se devuelve ninguna matriz de problemas de propiedad aunque no se hayan establecido algunas propiedades.
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.
NotaGetAttribIMsgOnIStg y SetAttribIMsgOnIStg no funcionan en todos los objetos IMessage . Solo son válidos para los objetos IMessage-on-IStorage devueltos por OpenIMsgOnIStg.
En el parámetro lpPropAttrs , el número y la posición de los atributos deben coincidir con el número y la posición de las etiquetas de propiedad pasadas en el parámetro lpPropTags .
La función SetAttribIMsgOnIStg se usa para hacer que las propiedades del mensaje sean de solo lectura cuando el esquema IMessage lo requiera. El proveedor de almacén de mensajes de ejemplo lo usa para este propósito. Para obtener más información, vea Mensajes.