• Article

ListDetachedDBFiles 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 ListDetachedDBFiles method lists all database files referenced by a primary database file.

Syntax

object.ListDetachedDBFiles(MDFName)asNameList

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • MDFName
    String that contains the name of a detached Microsoft SQL Server database file.

Prototype (C/C++)

HRESULT ListDetachedDBFiles(
SQLDMO_LPCSTR MDFName, 
LPSQLDMONAMELIST *ppFileNames);

Remarks

An application calls ListDetachedDBFiles to retrieve a complete list of detached database files. The application can then call IsDetachedPrimaryFile to determine which of the files is the primary file.

Note

If an application calls ListDetachedDBFiles on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.

Applies To:

SQLServer2 Object