Share via


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.

Note

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

Applies To: