IPropData::HrGetPropAccess
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 Eigenschaftstags, die die Eigenschaften angeben, für die Zugriffsebenen und status abgerufen werden sollen; andernfalls ein Zeiger auf NULL, der angibt, dass HrGetPropAccess Zugriffsebenen und status für alle Eigenschaften abrufen soll. Bei der Ausgabe wurde ein Array von Eigenschaftstags, für die Zugriffs- und status-Flags abgerufen wurden. Die Flags werden in dem Array gespeichert, auf das der lprgulAccess-Parameter verweist.
lprgulAccess
[out] Ein Zeiger auf ein Array von Bitmasken Kennzeichnung. Jede Bitmaske gibt die Zugriffsebenen oder status oder beides für jede der Eigenschaften an, die im Array identifiziert werden, auf das der lpPropTagArray-Parameter verweist. Die beiden Arrays sind insofern positioniert, als die erste Bitmaske, auf die lprgulAccess verweist, die erste Eigenschaft beschreibt, auf die 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 das von lppPropTagArray verwiesen wird, gelöscht wurde, legt HrGetPropAccess den Arrayeintrag bei der 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 deren IPROP_DIRTY Flag 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.