GenerateCreationSQL Method
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 GenerateCreationSQL method returns a string that contains a Transact-SQL command batch used to create the Microsoft SQL Server index defined by the properties of the Index object used.
Syntax
object
.GenerateCreationSQL(
Table
)
as
String
Parts
- object
Expression that evaluates to an object in the Applies To list.
- Table
Expression that evaluates to a SQL Distributed Management Objects (SQL-DMO) Table object.
Prototype (C/C++)
HRESULT GenerateCreationSQL(
LPSQLDMOTABLE TargetTable,
SQLDMO_LPBSTR Messages);
Note
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.
Returns
A Transact-SQL command batch as a string.
Remarks
The Index object exposes the GenerateSQL and GenerateCreationSQL methods. Both methods generate a command batch that creates an index. However, the Transact-SQL command batch returned by the GenerateCreationSQL method prefixes an index creation statement with a statement conditionally dropping the index.
For more information about using the GenerateSQL and GenerateCreationSQL methods, see GenerateSQL Method (Index).