SmoApplication.EnumAvailableSqlServers Method (String)

Enumerates a list of available instances of Microsoft SQL Server that are installed on the computer with the specified instance name.

Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Shared Function EnumAvailableSqlServers ( _
    name As String _
) As DataTable

public static DataTable EnumAvailableSqlServers (
    string name
)

public:
static DataTable^ EnumAvailableSqlServers (
    String^ name
)

public static DataTable EnumAvailableSqlServers (
    String name
)

public static function EnumAvailableSqlServers (
    name : String
) : DataTable

Parameters

• name
  A String value that specifies the name of the computer on which the instances of SQL Server are installed or a single instance of SQL Server.

Return Value

A DataTable system object value that contains an enumerated list of information about the available instances of SQL Server on the specified computer. If a single instance of SQL Server is specified in the name parameter, instead of a computer name, results are returned for the specified instance only. The table describes the different columns of the returned DataTable.

Remarks

Updated text:

The computer that is running the instance SQL Server might not receive responses to the EnumAvailableSqlServers method in a timely manner. The returned list might not show all the available instances of SQL Server on the network. When you call the EnumAvailableSqlServers method in subsequent tries, more servers might become visible on the network.

This method fails to list the local instance if a firewall is operating on the server. The firewall blocks any broadcast traffic issued when the method is called, even if the sender is from local machine.

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Example

How to: Register Event Handlers and Subscribe to Event Handling in Visual Basic .NET

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

SmoApplication Class
SmoApplication Members
Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Handling SMO Events

Change History