IPropData::HrSetPropAccess
Hace referencia a: Outlook 2013 | Outlook 2016
Establece el nivel de acceso o el estado de una o varias de las propiedades del objeto.
HRESULT HrSetPropAccess(
LPSPropTagArray lpPropTagArray,
ULONG FAR * rgulAccess
);
Parameters
lpPropTagArray
[entrada] Un puntero a una matriz de etiquetas de propiedad que indican las propiedades que desea modificar.
rgulAccess
[entrada] Una matriz de m�scaras de bits de indicador. Cada máscara de bits indica los niveles de acceso o el estado, o ambos, para cada una de las propiedades identificadas en la matriz a la que apunta el parámetro lpPropTagArray . Las dos matrices son posicionales en que la primera máscara de bits de rgulAccess describe la primera propiedad a la que apunta lpPropTagArray , etc. Para cada etiqueta de propiedad, se puede establecer un indicador de nivel de acceso y el indicador de estado de uno. En la siguiente tabla muestra los indicadores de posibles.
| Indicador de nivel de acceso | Indicador de estado |
|---|---|
| IPROP_READONLY, que indica que no se puede modificar la propiedad |
IPROP_CLEAN, que indica que la propiedad no se ha modificado. |
| IPROP_READWRITE, que indica que se puede modificar la propiedad. | IPROP_DIRTY, que indica que se ha modificado la propiedad. |
Valor devuelto
S_OK
Los indicadores de estado y el nivel de acceso se han establecido correctamente.
MAPI_E_NO_ACCESS
Se intent� establecer una propiedad en un objeto de s�lo lectura o un objeto para el que el llamador no tiene permisos suficientes.
MAPI_E_INVALID_PARAMETER
El parámetro rgulAccess contiene una combinación no válida de marcas, como IPROP_READONLY y IPROP_READWRITE.
Comentarios
El método IPropData::HrSetPropAccess cambia el nivel de acceso y el estado de las propiedades identificadas por las etiquetas de propiedad de la estructura SPropTagArray a la que apunta el parámetro lpPropTagArray . Para cada propiedad, hay una entrada correspondiente en la matriz rgulAccess . La entrada se puede establecer en una marca que indica el nivel de acceso de la propiedad y otra marca que indica su estado.
Notas para los llamadores
Utilice HrSetPropAccess para determinar cuando cambia un valor de esa propiedad y cambiar el nivel de acceso para una o varias de las propiedades de un objeto.