ListInstalledInstances Method

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

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

Syntaxe

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.

Notes

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.

[!REMARQUE]

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

Applies To: