HrOpenABEntryWithProviderUID

適用対象: Outlook 2013 | Outlook 2016

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

HRESULT HrOpenABEntryWithProviderUID(
  const MAPIUID *pEmsabpUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

パラメーター

pEmsmdbUID

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

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]開いているエントリのポインターへのポインター。