Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Outlook 2013 | Outlook 2016
Ruft die Zugriffsebene und den Status für eine oder mehrere der Eigenschaften des Objekts an.
HRESULT HrGetPropAccess(
LPSPropTagArray FAR * lppPropTagArray,
ULONG FAR * FAR * lprgulAccess
);
Parameter
lppPropTagArray
[in, out] Bei der Eingabe ein Array von Eigenschaftentags, das die Eigenschaften angibt, für die Zugriffsebenen und Status abgerufen werden sollen. andernfalls ein Zeiger auf NULL, der angibt, dass HrGetPropAccess-Zugriffsebenen und den Status für alle Eigenschaften abrufen soll. Bei der Ausgabe handelt es sich um ein Array von Eigenschaftstags, für die Zugriffs- und Statuskennzeichnungen abgerufen wurden. Die Kennzeichnungen werden in dem Array gespeichert, auf das der Parameter lprgulAccess zeigt.
lprgulAccess
[out] Ein Zeiger auf 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, auf die lprgulAccess, die erste Eigenschaft beschreibt, auf lpPropTagArray verweist usw. Für jedes Eigenschaftentags können die folgenden Kennzeichen festgelegt werden:
| 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 Access-Ebene und den Status Kennzeichen für die Eigenschaften wurden erfolgreich zurückgegeben.
Hinweise
Die IPropData::HrGetPropAccess -Methode ruft eine Reihe von Flags, die die Zugriffsebene und den Status für eine oder mehrere Eigenschaften angibt.
Hinweise für Aufrufer:
Sie können HrGetPropAccess für folgende Zwecke verwenden:
Um zu bestimmen, ob ein Client geändert oder schreibbare Eigenschaft gelöscht.
Um einen Client nicht Ändern oder Löschen einer Eigenschaft mithilfe der Methods IMAPIProp zu verhindern.
Wenn eine der Eigenschaften im Eigenschaftentagarray, auf die lppPropTagArray zeigt, gelöscht wurde, legt HrGetPropAccess den Arrayeintrag für die Ausgabe auf 0 fest. Wenn Sie lppPropTagArray auf NULL festlegen und eine der Eigenschaften des Objekts gelöscht wurde, wird die gelöschte Eigenschaft im Array zurückgegeben.
Wenn eine Eigenschaft geändert wurde, wird ihre IPROP_DIRTY-Kennzeichnung im entsprechenden Eintrag im Array festgelegt, auf das lprgulAccess verweist. Weder IPROP_READONLY noch IPROP_READWRITE wird festgelegt.
Wenn eine Eigenschaft nicht geändert oder gelöscht wurde, wird nur das Flag IPROP_READONLY oder IPROP_READWRITE festgelegt werden.