• Article

IsDetachedPrimaryFile 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.

TheIsDetachedPrimaryFile method specifies whether a file is a detached primary database file.

Syntax

object
.IsDetachedPrimaryFile(
MDFName
)
as Boolean

Parts

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

  • MDFName
    String that contains the name of the primary Microsoft SQL Server database or log file.

Prototype (C/C++)

HRESULT IsDetachedPrimaryFile(
SQLDMO_LPCSTR MDFName, 
LPBOOL pRetVal);

Remarks

Prior to calling IsDetachedPrimaryFile, an application should call the ListDetachedDBFiles property to retrieve a complete list of detached database files or ListDetachedLogFiles property to retrieve a complete list of detached log files. The application can then call IsDetachedPrimaryFile to determine which of the files is the primary file.

Note

If an application calls IsDetachedPrimaryFile 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