InstAPI.GetSQLServerByID 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
透過給定的實例 ID 和主機名稱,取得 SQL 實例的伺服器名稱。
多載
| 名稱 | Description |
|---|---|
| GetSQLServerByID(String, INST_ID, StringBuilder, UInt32) |
已淘汰.
透過給定的實例 ID 和主機名稱,取得 SQL 實例的伺服器名稱。 |
| GetSQLServerByID(String, INST_ID) |
透過給定的實例 ID 和主機名稱,取得 SQL 實例的伺服器名稱。 |
GetSQLServerByID(String, INST_ID, StringBuilder, UInt32)
警告
This overload is obsolete; use GetSQLServerByID(hostName, instanceID), instead.
透過給定的實例 ID 和主機名稱,取得 SQL 實例的伺服器名稱。
public:
static bool GetSQLServerByID(System::String ^ hostName, Microsoft::SqlServer::INST_ID ^ instanceID, System::Text::StringBuilder ^ sqlServerName, System::UInt32 % bufferSize);
[System.Obsolete("This overload is obsolete; use GetSQLServerByID(hostName, instanceID), instead.")]
public static bool GetSQLServerByID(string hostName, Microsoft.SqlServer.INST_ID instanceID, System.Text.StringBuilder sqlServerName, ref uint bufferSize);
[<System.Obsolete("This overload is obsolete; use GetSQLServerByID(hostName, instanceID), instead.")>]
static member GetSQLServerByID : string * Microsoft.SqlServer.INST_ID * System.Text.StringBuilder * uint32 -> bool
Public Shared Function GetSQLServerByID (hostName As String, instanceID As INST_ID, sqlServerName As StringBuilder, ByRef bufferSize As UInteger) As Boolean
參數
- hostName
- String
一個指向伺服器主機名稱的指標。
- instanceID
- INST_ID
指向相關實例的實例 ID 指標。
- sqlServerName
- StringBuilder
一個指向緩衝區的指標,用來接收 SQL 伺服器名稱。
- bufferSize
- UInt32
一個指向 DWORD 值的指標,用以提供緩衝區的長度。 若緩衝區太小,則回傳所需長度。
傳回
true若呼叫成功;否則,。 false
- 屬性
適用於
GetSQLServerByID(String, INST_ID)
透過給定的實例 ID 和主機名稱,取得 SQL 實例的伺服器名稱。
public:
static System::String ^ GetSQLServerByID(System::String ^ hostName, Microsoft::SqlServer::INST_ID ^ instanceID);
public static string GetSQLServerByID(string hostName, Microsoft.SqlServer.INST_ID instanceID);
static member GetSQLServerByID : string * Microsoft.SqlServer.INST_ID -> string
Public Shared Function GetSQLServerByID (hostName As String, instanceID As INST_ID) As String
參數
- hostName
- String
一個指向伺服器主機名稱的指標。
- instanceID
- INST_ID
指向相關實例的實例 ID 指標。
傳回
SQL 實例的伺服器名稱,依實例 ID 與主機名稱表示。