發行項
09/24/2010

EnumAvailableSqlServers 方法 (String)

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

命名空間： Microsoft.SqlServer.Management.Smo
組件： Microsoft.SqlServer.Smo (在 Microsoft.SqlServer.Smo.dll 中)

語法

'宣告
Public Shared Function EnumAvailableSqlServers ( _
    name As String _
) As DataTable
'用途
Dim name As String
Dim returnValue As DataTable

returnValue = SmoApplication.EnumAvailableSqlServers(name)

public static DataTable EnumAvailableSqlServers(
    string name
)

public:
static DataTable^ EnumAvailableSqlServers(
    String^ name
)

static member EnumAvailableSqlServers : 
        name:string -> DataTable

public static function EnumAvailableSqlServers(
    name : String
) : DataTable

參數

name
型別：System. . :: . .String
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.

傳回值

型別：System.Data. . :: . .DataTable
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.

Column	Data type	Description
Name	String	The name of the instance of SQL Server.
Server	String	The name of the server on which the instance of SQL Server is installed.
Instance	String	The instance of SQL Server.
IsClustered	Boolean	A Boolean value that is True if the instance is participating in failover clustering, or False if it is not.
Version	String	The version of the instance of SQL Server.
IsLocal	Boolean	A Boolean value that is True if the instance is local, or False if the instance is remote.

備註

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.