Freigeben über


IPropData::HrSetPropAccess

Gilt für: Outlook 2013 | Outlook 2016

Legt die Zugriffsebene oder Status für eine oder mehrere der Eigenschaften des Objekts fest.

HRESULT HrSetPropAccess(
  LPSPropTagArray lpPropTagArray,
  ULONG FAR * rgulAccess
);

Parameter

lpPropTagArray

[in] Ein Zeiger auf ein Array von Eigenschaftentags, die angeben, die Eigenschaften geändert werden soll.

rgulAccess

[in] Ein Array von Bitmasken Kennzeichnung. Jede Bitmaske gibt die Zugriffsebenen oder den Status oder beides für jede der Eigenschaften an, die im Array identifiziert werden, auf das der lpPropTagArray-Parameter zeigt. Die beiden Arrays sind so positioniert, dass die erste Bitmaske in rgulAccess die erste Eigenschaft beschreibt, auf die lpPropTagArray verweist usw. Für jedes Eigenschaftentags kann ein Zugriffsebene Flag und ein Status-Flag festgelegt werden. Die folgende Tabelle zeigt die möglichen Flags.

Zugriffsebene flag Status-flag
IPROP_READONLY, die angibt, dass die Eigenschaft nicht geändert werden kann
IPROP_CLEAN, die angibt, dass die Eigenschaft nicht geändert wurde.
IPROP_READWRITE, die angibt, dass die Eigenschaft geändert werden kann. IPROP_DIRTY, die angibt, dass die Eigenschaft geändert wurde.

Rückgabewert

S_OK

Die Zugriffsebene und den Status Kennzeichen wurden erfolgreich festgelegt.

MAPI_E_NO_ACCESS

Es wurde versucht, eine Eigenschaft für ein schreibgeschütztes Objekt oder ein Objekt für den Anrufer nicht über ausreichende Berechtigungen verfügt festlegen.

MAPI_E_INVALID_PARAMETER

Der rgulAccess-Parameter enthält eine ungültige Kombination von Flags, z. B. IPROP_READONLY und IPROP_READWRITE.

Hinweise

Die IPropData::HrSetPropAccess-Methode ändert die Zugriffsebene und den Status für die Eigenschaften, die von den Eigenschaftentags in der SPropTagArray-Struktur identifiziert werden, auf die der lpPropTagArray-Parameter zeigt. Für jede Eigenschaft gibt es einen entsprechenden Eintrag im Array rgulAccess. Der Eintrag kann festgelegt werden, um ein Flag, das die Eigenschaft Zugriffsebene und ein weiteres angibt Flag, das den Status angibt.

Hinweise für Aufrufer

Verwenden Sie HrSetPropAccess, um bei Änderung eines bestimmten-Eigenschaft ermitteln und die Zugriffsebene für eine oder mehrere der Eigenschaften eines Objekts zu ändern.

Siehe auch

SPropTagArray

IPropData: IMAPIProp