IAddrBook：:P repareRecips
適用於：Outlook 2013 |Outlook 2016
準備收件者清單以供傳訊系統稍後使用。
HRESULT PrepareRecips(
ULONG ulFlags,
LPSPropTagArray lpSPropTagArray,
LPADRLIST lpRecipList
);
參數
ulFlags
[in]控制項目開啟方式的旗標位掩碼。 您可以設定下列旗標：
MAPI_CACHE_ONLY
僅使用離線通訊錄來執行名稱解析。 例如，您可以使用此旗標來允許用戶端應用程式在快取交換模式中開啟 GAL) 的全域通訊清單 (，以及從快取存取該通訊簿中的專案，而不需要在用戶端與伺服器之間建立流量。 只有 Exchange 通訊簿提供者支援此旗標。
lpSPropTagArray
[in] SPropTagArray 結構的指標，其中包含屬性標記的陣列，指出需要更新的屬性。 lpSPropTagArray 參數可以是 NULL。
lpRecipList
[in]包含收件者清單的 ADRLIST 結構指標。
傳回值
S_OK
已成功備妥收件者清單。
註解
用戶端和服務提供者會呼叫 PrepareRecips 方法來執行下列動作：
確定 lpRecipList 參數中的所有收件者都有長期的項目標識碼。
請確定 lpRecipList 參數中的每個收件者都有 lpSPropTagArray 參數中所列的屬性，而且這些屬性會出現在收件者清單的開頭。
MAPI 會將每個收件者的短期專案標識碼轉換成長期專案標識碼。 如有必要，會從適當的通訊簿提供者擷取收件者的長期專案標識碼，並要求任何其他屬性。
在個別的收件者專案中，要求的屬性會先排序，然後再排序專案已存在的任何屬性。 如果 lpSPropTagArray 參數中的一或多個要求屬性不是由適當的通訊簿提供者處理，則其屬性類型會設定為 PT_ERROR。 其屬性值會設定為 MAPI_E_NOT_FOUND 或另一個值，以提供無法使用屬性的更具體原因。 lpRecipList 參數中包含的每個 SPropValue 結構都必須使用 MAPIAllocateBuffer 和 MAPIAllocateMore 函式個別配置，以便個別釋放。
如需PT_ERROR的相關信息，請參閱 屬性類型。