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.