ListInstalledInstances 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 ListInstalledInstances method returns a NameList object that enumerates all installed instances of Microsoft SQL Server on the local or specified computer.

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.

Applies To: