ISearchProtocol::CreateAccessor method (searchapi.h)

2021-10-13

Creates and initializes an IUrlAccessor object.

Syntax

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

Parameters

[in] pcwszURL

Type: LPCWSTR

Pointer to a null-terminated Unicode string containing the URL of the item being accessed.

[in] pAuthenticationInfo

Type: AUTHENTICATION_INFO*

Pointer to an AUTHENTICATION_INFO structure that contains authentication information necessary for accessing this item in the content source.

[in] pIncrementalAccessInfo

Type: INCREMENTAL_ACCESS_INFO*

Pointer to an INCREMENTAL_ACCESS_INFO structure that contains incremental access information, such as the last time the file was accessed by the gatherer.

[in] pItemInfo

Type: ITEM_INFO*

Pointer to an ITEM_INFO structure that contains information about the URL item, such as the name of the item's workspace catalog.

[out] ppAccessor

Type: IUrlAccessor**

Receives the address of a pointer to the IUrlAccessor object created by this method. This object contains information about the URL item, such as the item's file name.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The protocol host calls this method on the protocol handler once for every URL processed by the gatherer and retrieves a pointer to the IUrlAccessor object. This method creates and initializes an IUrlAccessor object to process an item currently being accessed by the gatherer.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 with SP1 [desktop apps only]
Target Platform	Windows
Header	searchapi.h
Redistributable	Windows Desktop Search (WDS) 3.0

Share via