Compartilhar via


Método ISearchManager2::CreateCatalog (searchapi.h)

Cria um novo catálogo personalizado no indexador do Windows Search e retorna uma referência a ele.

Sintaxe

HRESULT CreateCatalog(
  [in]  LPCWSTR               pszCatalog,
  [out] ISearchCatalogManager **ppCatalogManager
);

Parâmetros

[in] pszCatalog

Tipo: LPCWSTR

Nome do catálogo a ser criado. Pode ser qualquer nome selecionado pelo chamador, deve conter apenas caracteres alfanuméricos padrão e sublinhado.

[out] ppCatalogManager

Tipo: ISearchCatalogManager**

Com êxito, uma referência ao catálogo criado é retornada como um ponteiro de interface ISearchCatalogManager . O Release() deve ser chamado nessa interface depois que o aplicativo de chamada terminar de usá-lo.

Retornar valor

Tipo: HRESULT

HRESULT indicando status de operação:

Código de retorno Descrição
S_OK
O catálogo não existia anteriormente e foi criado. Referência ao catálogo retornado.
S_FALSE
Catálogo anteriormente existente, referência ao catálogo retornado.
 

HRESULT COM FALHA: falha ao criar catálogo ou argumentos inválidos passados.

Comentários

Chamado para criar um novo catálogo no indexador do Windows Search. Após a criação, os métodos no gerenciador ISearchCatalog retornado podem ser usados para adicionar locais a serem indexados, monitorar o processo de indexação e construir consultas para enviar ao indexador e obter resultados. Para obter mais informações, consulte Gerenciando o índice.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho searchapi.h

Confira também

ISearchManager2