IPropData：：HrAddObjProps
適用於：Outlook 2013 |Outlook 2016
將類型為 PT_OBJECT的一或多個屬性加入至物件。
HRESULT HrAddObjProps(
LPSPropTagArray lpPropTagArray,
LPSPropProblemArray FAR * lppProblems
);
參數
lpPropTagArray
[in]屬性標記陣列的指標，指出要加入的屬性。
lppProblems
[in， out]在輸入時， SPropProblemArray 結構的有效指標，或 NULL。 在輸出上，結構指標指標包含無法新增之屬性的相關信息，或 NULL。 只有在傳入有效的指標時，才會傳回屬性問題陣列結構的指標。
傳回值
S_OK
已成功新增屬性。
MAPI_E_INVALID_TYPE
在 lpPropTagArray 參數所指向的數位中傳遞了PT_OBJECT以外的屬性類型。
MAPI_E_NO_ACCESS
對象已設定為不允許讀取/寫入許可權。
MAPI_W_PARTIAL_COMPLETION
已新增部分但並非全部的屬性。
註解
IPropData：：HrAddObjProps 方法會將類型PT_OBJECT的一或多個屬性新增至 物件。 HrAddObjProps 提供物件屬性 之 IMAPIProp：：SetProps 方法的替代方法，因為呼叫 SetProps 無法建立物件屬性。 加入物件屬性會導致屬性標籤包含在 IMAPIProp：：GetPropList 方法傳回的屬性標籤清單中。
呼叫者注意事項
如果 HrAddObjProps 傳回MAPI_W_PARTIAL_COMPLETION，而且您已將 lppProblems 設定為有效的指標，請檢查傳回 的 SPropProblemArray 結構，以找出未新增哪些屬性。 一般而言，唯一發生的問題是記憶體不足。 在完成後呼叫 MAPIFreeBuffer 函式，以釋放 SPropProblemArray 結構。
若要新增屬性，目標對象必須具有讀取/寫入許可權。 如果 HrAddObjProps 傳回MAPI_E_NO_ACCESS，則無法將屬性新增至 對象，因為它不允許修改。 若要在呼叫 HrAddObjProps 之前取得對象的讀取/寫入許可權，請呼叫 IPropData：：HrSetObjAccess ，並將 ulAccess 參數設定為 IPROP_READWRITE。