IPropData::HrGetPropAccess
Hace referencia a: Outlook 2013 | Outlook 2016
Recupera el nivel de acceso y el estado de una o varias de las propiedades del objeto.
HRESULT HrGetPropAccess(
LPSPropTagArray FAR * lppPropTagArray,
ULONG FAR * FAR * lprgulAccess
);
Parameters
lppPropTagArray
[entrada, salida] En la entrada, una matriz de etiquetas de propiedad que indican las propiedades para el que se va a recuperar los niveles de acceso y el estado; de lo contrario, un puntero a un valor NULL, que indica que HrGetPropAccess debe recuperar los niveles de acceso y el estado de todas las propiedades. En la salida, se recupera una matriz de etiquetas de propiedad para los indicadores de acceso y el estado. Las marcas se almacenan en la matriz a la que apunta el parámetro lprgulAccess .
lprgulAccess
[out] Un puntero a 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 a la que apunta lprgulAccess describe la primera propiedad a la que apunta lpPropTagArray , etc. Para cada etiqueta de propiedad, se pueden establecer los siguientes indicadores:
| 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 para las propiedades correctamente se han devuelto.
Comentarios
El m�todo IPropData::HrGetPropAccess recupera un conjunto de marcadores que indica el nivel de acceso y el estado de una o m�s propiedades.
Notas para autores de llamada:
Puede usar HrGetPropAccess para los siguientes prop�sitos:
Para determinar si un cliente cambia o elimina una propiedad de escritura.
Para evitar que a un cliente cambiar o eliminar una propiedad mediante el uso de los m�todos de IMAPIProp .
Si se ha eliminado una de las propiedades de la matriz de etiquetas de propiedad a la que apunta lppPropTagArray , HrGetPropAccess establece la entrada de matriz en 0 en la salida. Si establece lppPropTagArray en NULL y se ha eliminado una de las propiedades del objeto, la propiedad eliminada se devuelve en la matriz.
Si se ha modificado una propiedad, su marca de IPROP_DIRTY se establece en la entrada correspondiente de la matriz a la que apunta lprgulAccess . Se establecer� IPROP_READONLY ni IPROP_READWRITE.
Si una propiedad no se ha modificado o eliminado, se establecer� el indicador IPROP_READONLY o IPROP_READWRITE.