ListInstalledInstances Method

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.

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.

Hinweise

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.

HinweisHinweis

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

Applies To: