Método ISearchProtocol2::CreateAccessorEx (searchapi.h)

Cria e inicializa um objeto IUrlAccessor . Esse método tem a mesma funcionalidade básica que o método ISearchProtocol::CreateAccessor , mas inclui um parâmetro pUserData adicional para fornecer dados adicionais ao manipulador de protocolo.

Sintaxe

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

Parâmetros

[in] pcwszURL

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a URL do item que está sendo acessado.

[in] pAuthenticationInfo

Tipo: AUTHENTICATION_INFO*

Ponteiro para uma estrutura AUTHENTICATION_INFO que contém informações de autenticação necessárias para acessar esse item na fonte de conteúdo.

[in] pIncrementalAccessInfo

Tipo: INCREMENTAL_ACCESS_INFO*

Ponteiro para uma estrutura INCREMENTAL_ACCESS_INFO que contém informações de acesso incremental, como a última vez em que o arquivo foi acessado pelo coletor.

[in] pItemInfo

Tipo: ITEM_INFO*

Ponteiro para uma estrutura ITEM_INFO que contém informações sobre o item de URL, como o nome do catálogo de workspaces do item.

[in] pUserData

Tipo: const BLOB*

Ponteiro para informações do usuário. Esses dados podem ser o que o originador de notificação decidir. Se o manipulador de protocolo implementar essa interface, ele receberá esses dados. Nem todas as notificações têm esse blob definido.

[out] ppAccessor

Tipo: IUrlAccessor**

Recebe o endereço de um ponteiro para o objeto IUrlAccessor criado por esse método. Esse objeto contém informações sobre o item de URL, como o nome do arquivo do item.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método cria e inicializa um objeto IUrlAccessor para processar um item que está sendo acessado pelo coletor. O host de protocolo chama esse método no manipulador de protocolo. Esse método é chamado uma vez para cada URL processada pelo coletor e recupera um ponteiro para o objeto IUrlAccessor .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	searchapi.h
Redistribuível	Pesquisa da Área de Trabalho do Windows (WDS) 3.0