Metodo ISearchProtocol2::CreateAccessorEx (searchapi.h)

Crea e inizializza un oggetto IUrlAccessor . Questo metodo ha la stessa funzionalità di base del metodo ISearchProtocol::CreateAccessor , ma include un parametro pUserData aggiuntivo per fornire dati aggiuntivi al gestore del protocollo.

Sintassi

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
);

Parametri

[in] pcwszURL

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione Null contenente l'URL dell'elemento a cui si accede.

[in] pAuthenticationInfo

Tipo: AUTHENTICATION_INFO*

Puntatore a una struttura AUTHENTICATION_INFO che contiene le informazioni di autenticazione necessarie per accedere a questo elemento nell'origine del contenuto.

[in] pIncrementalAccessInfo

Tipo: INCREMENTAL_ACCESS_INFO*

Puntatore a una struttura di INCREMENTAL_ACCESS_INFO che contiene informazioni di accesso incrementale, ad esempio l'ultima volta che il file è stato eseguito dal servizio Gatherer.

[in] pItemInfo

Tipo: ITEM_INFO*

Puntatore a una struttura ITEM_INFO contenente informazioni sull'elemento URL, ad esempio il nome del catalogo dell'area di lavoro dell'elemento.

[in] pUserData

Tipo: CONST BLOB*

Puntatore alle informazioni utente. Questi dati possono essere indipendentemente dal fatto che l'originatore di notifica decida. Se il gestore del protocollo implementa questa interfaccia, riceverà questi dati. Non tutte le notifiche hanno questo set di BLOB.

[out] ppAccessor

Tipo: IUrlAccessor**

Riceve l'indirizzo di un puntatore all'oggetto IUrlAccessor creato da questo metodo. Questo oggetto contiene informazioni sull'elemento URL, ad esempio il nome file dell'elemento.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo crea e inizializza un oggetto IUrlAccessor per elaborare un elemento attualmente accessibile dal servizio Gatherer. L'host del protocollo chiama questo metodo nel gestore del protocollo. Questo metodo viene chiamato una volta per ogni URL elaborato dal servizio Gatherer e recupera un puntatore all'oggetto IUrlAccessor .

Requisiti