IPropData::HrGetPropAccess
S’applique à : Outlook 2013 | Outlook 2016
R�cup�re le niveau d'acc�s et l'�tat d'un ou plusieurs des propri�t�s de l'objet.
HRESULT HrGetPropAccess(
LPSPropTagArray FAR * lppPropTagArray,
ULONG FAR * FAR * lprgulAccess
);
Paramètres
lppPropTagArray
[entr�e, sortie] � l'entr�e, un tableau de balises de propri�t�s qui indiquent les propri�t�s pour lequel r�cup�rer des niveaux d'acc�s et l'�tat ; dans le cas contraire, un pointeur null, ce qui indique que HrGetPropAccess doit extraire les niveaux d'acc�s et l'�tat de toutes les propri�t�s. Dans la sortie, un tableau de balises de propri�t� pour les indicateurs d'acc�s et l'�tat ont �t� r�cup�r�s. Les indicateurs sont stockés dans le tableau vers lequel pointe le paramètre lprgulAccess .
lprgulAccess
[out] Pointeur vers un tableau de masques de bits indicateur. Chaque masque de bits indique les niveaux d’accès ou les status, ou les deux, pour chacune des propriétés identifiées dans le tableau vers lequel pointe le paramètre lpPropTagArray. Les deux tableaux sont positionnels en ce que le premier masque de bits que lprgulAccess pointe vers décrit la première propriété vers laquelle lpPropTagArray pointe, et ainsi de suite. Pour chaque balise de propri�t�, les indicateurs suivants peuvent �tre d�finis :
| Indicateur de niveau d'acc�s | Indicateur d'�tat |
|---|---|
| IPROP_READONLY, ce qui indique que la propri�t� ne peut pas �tre modifi�e. | IPROP_CLEAN, ce qui indique que la propri�t� n'a pas �t� modifi�e. |
| IPROP_READWRITE, ce qui indique que la propri�t� peut �tre modifi�e. | IPROP_DIRTY, ce qui indique que la propri�t� a �t� modifi�e. |
Valeur renvoyée
S_OK
Les indicateurs de niveau et l'�tat de l'acc�s pour les propri�t�s ont �t� renvoy�es avec succ�s.
Remarques
La m�thode IPropData::HrGetPropAccess r�cup�re un ensemble d'indicateurs qui indique le niveau d'acc�s et l'�tat d'une ou plusieurs propri�t�s.
Remarques aux appelants :
Vous pouvez utiliser HrGetPropAccess dans les cas suivants :
Pour d�terminer si un client modifi� ou supprim� une propri�t� accessible en �criture.
Pour emp�cher un client � partir de la modification ou suppression d'une propri�t� en utilisant les m�thodes IMAPIProp .
Si l’une des propriétés du tableau de balises de propriétés pointée par lppPropTagArray a été supprimée, HrGetPropAccess définit l’entrée du tableau sur 0 sur la sortie. Si vous définissez lppPropTagArray sur NULL et que l’une des propriétés de l’objet a été supprimée, la propriété supprimée est retournée dans le tableau.
Si une propriété a été modifiée, son indicateur IPROP_DIRTY est défini dans l’entrée correspondante du tableau vers lequel lprgulAccess pointe. Ni IPROP_READONLY ni IPROP_READWRITE sera d�finie.
Si une propri�t� n'a pas �t� modifi�e ou supprim�e, seul l'indicateur IPROP_READONLY ou IPROP_READWRITE sera d�finie.