IPropData：：HrSetPropAccess
適用於：Outlook 2013 |Outlook 2016
設定一或多個物件屬性的存取層級或狀態。
HRESULT HrSetPropAccess(
LPSPropTagArray lpPropTagArray,
ULONG FAR * rgulAccess
);
參數
lpPropTagArray
[in]屬性標記陣列的指標，指出要修改的屬性。
rgulAccess
[in]旗標位掩號的陣列。 每個位掩碼都會指出 lpPropTagArray 參數所指向數位中所識別之每個屬性的存取層級或狀態，或兩者皆為。 這兩個陣列的位置在於 rgulAccess 中的第一個位掩碼描述 lpPropTagArray 所指向的第一個屬性，依此類推。 針對每個屬性標記，可以設定一個存取層級旗標和一個狀態旗標。 下表顯示可能的旗標。
| 存取層級旗標 | 狀態旗標 |
|---|---|
| IPROP_READONLY，表示無法修改屬性 |
IPROP_CLEAN，表示屬性尚未修改。 |
| IPROP_READWRITE，表示可以修改屬性。 | IPROP_DIRTY，表示屬性已修改。 |
傳回值
S_OK
已成功設定存取層級和狀態旗標。
MAPI_E_NO_ACCESS
嘗試在只讀物件或呼叫端許可權不足的對象上設定屬性。
MAPI_E_INVALID_PARAMETER
rgulAccess 參數包含無效的旗標組合，例如IPROP_READONLY和IPROP_READWRITE。
註解
IPropData：：HrSetPropAccess 方法會變更屬性的存取層級和狀態，這些屬性是由 lpPropTagArray 參數所指向之 SPropTagArray 結構中的屬性卷標所識別。 針對每個屬性， rgulAccess 陣 列中有一個對應的專案。 專案可以設定為一個旗標，指出屬性的存取層級，而另一個旗標表示其狀態。
呼叫者注意事項
使用 HrSetPropAccess 來判斷特定屬性值何時變更，以及變更一或多個物件屬性的存取層級。