Dropping a SQL Server Index

OLE DB and SQL Server

OLE DB and SQL Server

Dropping a SQL Server Index

SQLOLEDB exposes the IIndexDefinition::DropIndex function, allowing consumers to remove an index from a Microsoft® SQL Server™ 2000 table.

SQLOLEDB exposes some SQL Server 2000 PRIMARY KEY and UNIQUE constraints as indexes. The table owner, database owner, and some administrative role members can alter a SQL Server 2000 table, dropping a constraint. By default, only the table owner can drop an existing index. Therefore, DropIndex success or failure depends not only on the application user's access rights but also on the type of index indicated.

Consumers specify the table name as a Unicode character string in the pwszName member of the uName union in the pTableID parameter. The eKind member of pTableID must be DBKIND_NAME.

Consumers specify the index name as a Unicode character string in the pwszName member of the uName union in the pIndexID parameter. The eKind member of pIndexID must be DBKIND_NAME. SQLOLEDB does not support the OLE DB feature of dropping all indexes on a table when pIndexID is null. If pIndexID is null, E_INVALIDARG is returned.

See Also

ALTER TABLE

DROP INDEX