ListInstalledInstances Method

SQL-DMO

SQL-DMO

ListInstalledInstances Method

The ListInstalledInstances method returns a NameList object that enumerates all installed instances of Microsoft® SQL Server™ 2000 on the local or specified computer.

Applies To
SQLServer2 Object
Syntax

object.ListInstalledInstances( [ ServerName ] ) as NameList

Parts

object

Expression that evaluates to an object in the Applies To list

ServerName

Optional string that specifies a remote server name

Prototype (C/C++)

HRESULT ListInstalledInstances(
LPSQLDMONAMELIST *ppServerNames,
SQLDMO_LPCSTR ServerName);

Returns

A NameList object that enumerates instances of SQL Server.

Remarks

By default, ListInstalledInstances returns a list of SQL Server instances on the local computer. When called with the optional ServerName parameter, ListInstalledInstances returns a list of SQL Server instances on a specified computer. ListInstalledInstances does not require a connection.

Note  If an application calls ListInstalledInstances on an instance of SQL Server version 7.0, an empty NameList object is returned.