HrOpenABEntryWithResolvedRow

適用対象: Outlook 2013 | Outlook 2016

HrOpenABEntryWithExchangeContext と同じ関数を実行します。ただし、解決された行から emsabpUID を自動的に取得し、entryID を開きます。

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

HRESULT HrOpenABEntryWithResolvedRow(
  LPSRow prwResolved,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

パラメーター

prwResolved

[in] emsabpUID を取得し 、entryID を開くために使用される解決された行へのポインター。

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