HrOpenABEntryUsingDefaultContext

適用於: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]開啟之專案的指標。