適用於:Outlook 2013 |Outlook 2016
執行與 HrOpenABEntryWithExchangeContext 相同的函式,不同之處在於它會使用舊版 emsmdbUID 作為 pEmsmdbUID 參數。 除非您無法取得呼叫 HrOpenABEntryWithExchangeContext 的正確 emsmdbUID,否則請勿使用此函式。
| 屬性 | 值 |
|---|---|
| 標頭檔: |
abhelp.h |
| 實作者: |
Mapi |
| 通話者: |
用戶端應用程式和服務提供者 |
HRESULT HrOpenABEntryUsingDefaultContext(
LPMAPISESSION pmsess,
LPADRBOOK pAddrBook,
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPUNKNOWN FAR * lppUnk
);
參數
pmsess
[in]登入 IMAPISession 的 。 它不能是 NULL。
pAddrBook
[in]用來開啟專案標識碼的通訊簿。 它不能是 NULL。
cbEntryID
[in] lpEntryID 參數所指定之專案標識碼的位元組計數。
lpEntryID
[in]項目標識碼的指標,表示要開啟的通訊簿專案。
lpInterface
[in]介面識別碼的指標, (用來存取開啟專案之介面的 IID) 。 傳遞 NULL 會傳回 對象的標準介面。 針對訊息使用者,標準介面是 IMailUser :IMAPIProp。 針對通訊組清單,它是 IDistList :IMAPIContainer,而對於容器,則是 IABContainer:IMAPIContainer。 呼叫端可以將 lpInterface 設定為適當的標準介面或繼承階層中的介面。
ulFlags
[in]控制項目開啟方式的旗標位掩碼。 您可以設定下列旗標:
MAPI_BEST_ACCESS
要求以允許的最大網路和客戶端許可權開啟專案。 例如,如果用戶端具有讀取和寫入許可權,通訊錄提供者會嘗試以讀取和寫入許可權開啟專案。 用戶端可以藉由呼叫開啟專案的 IMAPIProp::GetProps 方法並擷取 PR_ACCESS_LEVEL (PidTagAccessLevel) 屬性,來擷取授與的存取層級。
MAPI_CACHE_ONLY
只使用離線通訊錄來執行名稱解析。 例如,您可以使用此旗標來允許用戶端應用程式在快取交換模式中開啟 GAL) 的全域通訊清單 (,並從快取存取該通訊簿中的專案,而不需要在用戶端與伺服器之間建立流量。 只有 Exchange 通訊簿提供者支援此旗標。
MAPI_DEFERRED_ERRORS
允許呼叫成功,可能在專案完全開啟且可供使用之前,這表示後續對專案的呼叫可能會傳回錯誤。
MAPI_GAL_ONLY
只使用 GAL 來執行名稱解析。 只有 Exchange 通訊簿提供者支援此旗標。
MAPI_MODIFY
要求以讀取和寫入許可權開啟專案。 由於項目預設是以唯讀存取權開啟,因此客戶端不應該假設是否已設定讀取和寫入許可權MAPI_MODIFY。
MAPI_NO_CACHE
請不要使用離線通訊錄來執行名稱解析。 只有 Exchange 通訊簿提供者支援此旗標。
lpulObjType
[out]開啟之專案的型別指標。
lppUnk
[out]開啟之專案的指標。