IPropData::HrSetPropAccess
S’applique à : Outlook 2013 | Outlook 2016
D�finit le niveau d'acc�s ou un �tat pour un ou plusieurs des propri�t�s de l'objet.
HRESULT HrSetPropAccess(
LPSPropTagArray lpPropTagArray,
ULONG FAR * rgulAccess
);
Paramètres
lpPropTagArray
[in] Pointeur vers un tableau de balises de propri�t�s qui indiquent les propri�t�s � modifier.
rgulAccess
[in] Tableau des 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 dans la mesure où le premier masque de bits de rgulAccess décrit la première propriété vers laquelle lpPropTagArray pointe, et ainsi de suite. Pour chaque balise de propri�t�, un indicateur de niveau d'acc�s et l'indicateur d'�tat d'un seul peut �tre d�finie. Le tableau suivant pr�sente les indicateurs possibles.
| 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 d'�tat et le niveau d'acc�s ont �t� correctement d�finis.
MAPI_E_NO_ACCESS
Une tentative a �t� effectu�e pour d�finir la propri�t� sur un objet en lecture seule ou d'un objet pour lequel l'appelant dispose d'autorisations insuffisantes.
MAPI_E_INVALID_PARAMETER
Le paramètre rgulAccess contient une combinaison non valide d’indicateurs, tels que IPROP_READONLY et IPROP_READWRITE.
Remarques
La méthode IPropData ::HrSetPropAccess modifie le niveau d’accès et les status pour les propriétés identifiées par les balises de propriété dans la structure SPropTagArray vers laquelle pointe le paramètre lpPropTagArray. Pour chaque propriété, il existe une entrée correspondante dans le tableau rgulAccess . L'entr�e peut �tre d�finie sur un indicateur qui indique le niveau d'acc�s de la propri�t� et l'autre indicateur indiquant son statut.
Remarques pour les appelants
Utilisez HrSetPropAccess pour d�terminer quand une valeur de propri�t� particuli�re change et modifier le niveau d'acc�s pour un ou plusieurs des propri�t�s d'un objet.