ISearchProtocol2::CreateAccessorEx メソッド (searchapi.h)

IUrlAccessor オブジェクトを作成して初期化します。 このメソッドには ISearchProtocol::CreateAccessor メソッドと同じ基本的な機能がありますが、プロトコル ハンドラーに追加のデータを提供するための追加 の pUserData パラメーターが含まれています。

構文

HRESULT CreateAccessorEx(
  [in]  LPCWSTR                 pcwszURL,
  [in]  AUTHENTICATION_INFO     *pAuthenticationInfo,
  [in]  INCREMENTAL_ACCESS_INFO *pIncrementalAccessInfo,
  [in]  ITEM_INFO               *pItemInfo,
  [in]  const BLOB              *pUserData,
  [out] IUrlAccessor            **ppAccessor
);

パラメーター

[in] pcwszURL

種類: LPCWSTR

アクセスされるアイテムの URL を含む null で終わる Unicode 文字列へのポインター。

[in] pAuthenticationInfo

種類: AUTHENTICATION_INFO*

コンテンツ ソース内の このアイテムにアクセスするために必要な認証情報を含むAUTHENTICATION_INFO構造体へのポインター。

[in] pIncrementalAccessInfo

種類: INCREMENTAL_ACCESS_INFO*

増分アクセス情報を含む INCREMENTAL_ACCESS_INFO 構造体へのポインター (ファイルが最後に Gatherer によってアクセスされたときなど)。

[in] pItemInfo

種類: ITEM_INFO*

アイテム のワークスペース カタログの名前など、URL アイテムに関する情報を含むITEM_INFO構造体へのポインター。

[in] pUserData

型: const BLOB*

ユーザー情報へのポインター。 このデータは、通知元が決定した任意のデータにすることができます。 プロトコル ハンドラーがこのインターフェイスを実装すると、このデータが受信されます。 すべての通知にこの BLOB が設定されているわけではありません。

[out] ppAccessor

種類: IUrlAccessor**

このメソッドによって作成された IUrlAccessor オブジェクトへのポインターのアドレスを受け取ります。 このオブジェクトには、URL アイテムに関する情報 (アイテムのファイル名など) が含まれます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドは、Gatherer によって現在アクセスされている項目を処理する IUrlAccessor オブジェクトを作成および初期化します。 プロトコル ホストは、プロトコル ハンドラーでこのメソッドを呼び出します。 このメソッドは、Gatherer によって処理されるすべての URL に対して 1 回呼び出され、 IUrlAccessor オブジェクトへのポインターを取得します。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	searchapi.h
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0