LocalDBStartInstance 函式

適用於：SQL Server

啟動指定的 SQL Server Express LocalDB 實例。

標頭檔： msoledbsql.h

語法

HRESULT LocalDBStartInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           LPWSTR wszSqlConnection,   
           LPDWORD lpcchSqlConnection   
);  

參數

pInstanceName
[輸入]要啟動的 LocalDB 實例名稱。

dwFlags
[輸入]保留供日後使用。 目前應該設定為 0。

wszSqlConnection
[輸出]用來將連接字串儲存至 LocalDB 實例的緩衝區。

lpcchSqlConnection
[輸入/輸出]在輸入中，包含字元中的 wszSqlConnection 緩衝區大小 ，包括任何尾端 Null。 在輸出中，如果指定的緩衝區大小太小，則包含字元中所需的緩衝區大小，包括任何尾端 Null。

傳回

S_OK
此函數已成功。

LOCALDB_ERROR_NOT_INSTALLED
電腦上未安裝 SQL Server Express LocalDB。

LOCALDB_ERROR_INVALID_PARAMETER
一或多個指定的輸入參數無效。

LOCALDB_ERROR_INVALID_INSTANCE_NAME
指定的實例名稱無效。

LOCALDB_ERROR_UNKNOWN_INSTANCE
實例不存在。

LOCALDB_ERROR_INSUFFICIENT_BUFFER
指定的緩衝區 wszSqlConnection 太小。

LOCALDB_ERROR_WAIT_TIMEOUT
嘗試取得同步處理鎖定時發生逾時。

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
應儲存實例的路徑比MAX_PATH長。

LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
無法擷取使用者設定檔資料夾。

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
無法存取實例資料夾。

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
無法存取實例登錄。

LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
無法修改實例登錄。

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
無法建立 SQL Server 的進程。

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
SQL Server 進程已啟動，但 SQL Server 啟動失敗。

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
實例組態已損毀。

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
無法建立自動實例。 如需錯誤詳細資料，請參閱 Windows 應用程式事件記錄檔。

LOCALDB_ERROR_INTERNAL_ERROR
發生未預期的錯誤。 如需詳細資訊，請參閱事件記錄檔。

詳細資料

連接緩衝區引數 （ wszSqlConnection ） 和連接緩衝區大小引數 （ lpcchSqlConnection ） 都是選擇性的。 下表顯示使用這些引數及其結果的選項。

緩衝區	緩衝區大小	基本原理	動作
NULL	NULL	使用者想要啟動實例，而且不需要管道名稱。	啟動實例（沒有管道傳回，也沒有必要的緩衝區大小傳回）。
NULL	展示	使用者要求輸出緩衝區大小。 （在下一次呼叫中，使用者可能會要求實際開始。	傳回必要的緩衝區大小（沒有開始，也沒有管線傳回）。 結果S_OK。
展示	NULL	不允許;輸入不正確。	傳回的結果LOCALDB_ERROR_INVALID_PARAMETER。
展示	展示	使用者想要啟動實例，且需要管道名稱在啟動之後連線到它。	檢查緩衝區大小、啟動 實例，並傳回緩衝區中的管道名稱。 緩衝區大小引數會傳回 「server=」 字串的長度，不包括終止 Null。

如需使用 LocalDB API 的程式碼範例，請參閱 SQL Server Express LocalDB 參考 。

另請參閱

SQL Server Express LocalDB 標頭和版本資訊