ISearchManager2::CreateCatalog-Methode (searchapi.h)

Erstellt einen neuen benutzerdefinierten Katalog im Windows Search-Indexer und gibt einen Verweis darauf zurück.

Syntax

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

Parameter

[in] pszCatalog

Typ: LPCWSTR

Name des zu erstellenden Katalogs. Kann ein beliebiger Name sein, der vom Aufrufer ausgewählt wird, darf nur alphanumerische Standardzeichen und Unterstriche enthalten.

[out] ppCatalogManager

Typ: ISearchCatalogManager**

Bei Erfolg wird ein Verweis auf den erstellten Katalog als ISearchCatalogManager-Schnittstellenzeiger zurückgegeben. Release() muss auf dieser Schnittstelle aufgerufen werden, nachdem die aufrufende Anwendung die Verwendung abgeschlossen hat.

Rückgabewert

Typ: HRESULT

HRESULT, das status des Vorgangs angibt:

Rückgabecode	BESCHREIBUNG
S_OK	Der Katalog war zuvor nicht vorhanden und wurde erstellt. Verweis auf den zurückgegebenen Katalog.
S_FALSE	Katalog war zuvor vorhanden, Verweis auf den zurückgegebenen Katalog.

 

FAILED HRESULT: Fehler beim Erstellen eines Katalogs oder ungültiger Argumente.

Hinweise

Wird aufgerufen, um einen neuen Katalog im Windows Search-Indexer zu erstellen. Nach der Erstellung können die Methoden für den zurückgegebenen ISearchCatalog-Manager verwendet werden, um Speicherorte hinzuzufügen, die indiziert werden sollen, den Indizierungsprozess zu überwachen und Abfragen zu erstellen, um an den Indexer zu senden und Ergebnisse abzurufen. Weitere Informationen finden Sie unter Verwalten des Indexes.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	searchapi.h

Weitere Informationen

ISearchManager2