次の方法で共有

IAddrBook::GetSearchPath

  • [アーティクル]

適用対象: Outlook 2013 | Outlook 2016

IAddrBook::ResolveName メソッドによって開始される名前解決プロセスに含めるコンテナーのエントリ識別子の順序付きリストを返します。

HRESULT GetSearchPath(
  ULONG ulFlags,
  LPSRowSet FAR * lppSearchPath
);

パラメーター

ulFlags

[in]検索パスで返される文字列の型を制御するフラグのビットマスク。 次のフラグを設定できます。

MAPI_UNICODE

返される文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。

lppSearchPath

[out]コンテナー エントリ識別子の順序付きリストへのポインターへのポインター。 GetSearchPath は、順序付きリストを SRowSet 構造体に格納します。 アドレス帳階層にコンテナーがない場合は、 SRowSet 構造体に 0 が返されます。

戻り値

S_OK

検索パスが正常に取得されました。

注釈

クライアントとサービス プロバイダーは 、GetSearchPath メソッドを呼び出して、 ResolveName メソッドで名前を解決するために使用される検索パスを取得します。 通常、クライアントは IAddrBook::SetSearchPath メソッドを呼び出して、 GetSearchPath を呼び出して取得する前に、プロファイルにコンテナー検索パスを確立します。 ただし、 SetSearchPath の呼び出しは省略可能です。

SetSearchPath が呼び出されたことがない場合、GetSearchPath はアドレス帳の階層テーブルを操作してパスを構築します。 GetSearchPath によって確立される既定の検索パスは、次の順序で次のコンテナーで構成されます。

  1. 読み取り/書き込みアクセス許可を持つ最初のコンテナー (通常は個人用アドレス帳 (PAB)。

  2. PR_DISPLAY_TYPE (PidTagDisplayType) プロパティが DT_GLOBAL に設定されているすべてのコンテナー。 この設定は、コンテナーが受信者を保持することを示します。

  3. PR_DISPLAY_TYPE プロパティに DT_GLOBAL フラグが設定されているコンテナーがなく、既定のコンテナーが読み取り/書き込みアクセス許可を持つ最初のコンテナーと異なる場合、既定として指定されたコンテナー。

SetSearchPath が呼び出された場合、GetSearchPath は、プロファイルに格納されているアドレス帳コンテナーを使用してパスを構築します。 GetSearchPath は、呼び出し元にこのパスを返す前に、このパスを検証します。

SetSearchPath の最初の呼び出しの後、SetSearchPath への後続の呼び出しを使用して、GetSearchPath によって返される検索パスを変更する必要があります。 つまり、呼び出し元のクライアントまたはプロバイダーは 、SetSearchPath の最初の呼び出し後に既定の検索パスを受け取りません。

関連項目

IAddrBook::SetSearchPath

SRowSet

IAddrBook : IMAPIProp