HrOpenABEntryWithExchangeContext

適用対象: Outlook 2013 | Outlook 2016

pEmsmdbUID によって識別される Exchange アドレス帳を使用して entryID を開きます。 この関数は IAddrBook::D etails と同様に機能しますが、この関数を使用すると、想定される Exchange アドレス帳プロバイダーを使用して IAddrBook::OpenEntry が開かれます。

プロパティ	値
ヘッダー ファイル:	abhelp.h
実装元:	MAPI
呼び出し元:	クライアント アプリケーションとサービス プロバイダー

HRESULT HrDoABDetailsWithExchangeContext(
  LPMAPISESSION pmsess,
  const MAPIUID *pEmsmdbUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags
);

パラメーター

pmsess

[in] IMAPISession にログオンした 。 NULL にすることはできません。

pEmsmdbUID

[in]エントリ識別子の詳細を表示するためにこの関数が使用する Exchange アドレス帳プロバイダーを含む Exchange サービスを識別する emsmdbUID へのポインター。 受信エントリ識別子が Exchange アドレス帳プロバイダーエントリ識別子でない場合、このパラメーターは無視され、関数呼び出しは IAddrBook::D etails のように動作します。 このパラメーターが NULL または 0 の MAPIUID の場合、この関数は IAddrBook::D etails のように動作します。

pAddrBook

[in]エントリ識別子を開くために使用されるアドレス帳。 NULL にすることはできません。

cbEntryID

[in] lpEntryID パラメーターで指定されたエントリ識別子のバイト数。

lpEntryID

[in]開くアドレス帳エントリを表すエントリ識別子へのポインター。

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 アドレス帳プロバイダーによってのみサポートされます。