IAdminIndexServer::GetCatalogByName method

Article
05/31/2018

[Indexing Service is no longer supported as of Windows XP and is unavailable for use as of Windows 8. Instead, use Windows Search for client side search and Microsoft Search Server Express for server side search.]

Retrieves an existing catalog object from a catalog collection, given its name.

Syntax

HRESULT GetCatalogByName(
  [in]          BSTR      bstrCatalogName,
  [out, retval] IDispatch **pDisp
);

Parameters

bstrCatalogName [in]: The name of an existing catalog.
pDisp [out, retval]: The CatAdm object that represents the catalog. See ICatAdm.

Return value

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

Remarks

This method expects an existing catalog name. When you attempt to retrieve a nonexistent catalog object, Indexing Service returns an error object with the Number property set to ERROR_NOT_FOUND.

Examples

' Get a catalog object named "Sources"
Set objCatAdm = objAdminIS.GetCatalogByName("Sources")

Requirements


Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
End of client support	Windows 7
End of server support	Windows Server 2008 R2
DLL	Ciodm.dll

Share via