• Article

RootPath Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The RootPath property specifies an operating system directory used as the primary path for Microsoft Search full-text catalog storage.

Syntax

object
.RootPath [= value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    A string that specifies an existing operating system path

Data Type

String

Modifiable

Read/write when using the FullTextCatalog object to create a Microsoft Search full-text catalog. Read-only when referencing an existing Microsoft Search full-text catalog.

Prototype (C/C++)

HRESULT GetRootPath(SQLDMO_LPBSTR pRetVal);
HRESULT SetRootPath(SQLDMO_LPCSTR pRetVal);

Note

SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

Remarks

If the RootPath property is an empty string when creating a Microsoft Search full-text catalog, the default data path that is set for the Microsoft Search service is used. For more information, see DefaultPath Property.