FullTextIndexActive Property

SQL-DMO

SQL-DMO

FullTextIndexActive Property

The FullTextIndexActive property controls Microsoft Search service activity for a table.

Applies To
Table Object
Syntax

object.FullTextIndexActive [= value]

Part

object

Expression that evaluates to an object in the Applies To list

value

TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetFullTextIndexActive(LPBOOL pRetVal);

HRESULT SetFullTextIndexActive(BOOL NewVal);

Remarks

If TRUE, the referenced table is configured for participation in Microsoft Search full-text indexing. The Microsoft Search service will gather index data from the designated columns and populate the index as directed.

If FALSE, Microsoft Search will not gather index data from the referenced table regardless of configuration for full-text indexing participation.

Full-text indexing must be properly configured for the referenced table prior to setting FullTextIndexActive. For more information about full-text index configuration, see FullTextCatalogName Property, FullTextIndex Property, and UniqueIndexForFullText Property.

Note  Setting FullTextIndexActive to TRUE does not populate the Microsoft Search full-text catalog and the table will not be available for full-text queries. For more full-text on populating the Microsoft Search full-text catalog, see Start Method (FullTextCatalog).

If FullTextIndexActive is TRUE, setting it to TRUE generates an error. An error is also generated on attempts to set FullTextIndexActive to TRUE when full-text indexing has not been properly configured.

If FullTextIndexActive is TRUE, setting it to FALSE simply removes the referenced table from participation in full-text index build and query. Setting the property does not affect the established configuration.