LocalDBStopInstance 函數
停止執行指定的 SQL Server Express LocalDB 執行個體。
標頭檔: sqlncli.h
語法
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
ULONG ulTimeout
);
參數
pInstanceName
[輸入] 要停止的 LocalDB 執行個體名稱。
dwFlags
[輸入] 指定執行個體停止方式的一個或一組旗標值。
可用的旗標:
LOCALDB_SHUTDOWN_KILL_PROCESS
使用終止處理序作業系統命令立即關閉。
LOCALDB_SHUTDOWN_WITH_NOWAIT
使用 WITH NOWAIT 選項 Transact-SQL 命令關閉。
如果未設定任何旗標,則會使用 SHUTDOWN Transact-SQL 命令關閉 LocalDB 執行個體。 如果設定了這兩個旗標,則會優先使用 LOCALDB_SHUTDOWN_KILL_PROCESS 旗標。
ulTimeout
[輸入] 等候此作業完成的時間 (以秒為單位)。 如果此值為 0,此函數會立即傳回,而不等候 LocalDB 執行個體停止。
傳回
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_WAIT_TIMEOUT
嘗試取得同步處理鎖定時發生逾時。
LOCALDB_ERROR_INSTANCE_STOP_FAILED
停止作業無法在指定時間內完成。
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_INSTANCE_CONFIGURATION_CORRUPT
執行個體組態已損毀。
LOCALDB_ERROR_CALLER_IS_NOT_OWNER
API 呼叫端不是 LocalDB 執行個體擁有者。
LOCALDB_ERROR_INTERNAL_ERROR
發生意外錯誤。 請參閱事件記錄檔,以取得詳細資料。
備註
如需使用 LocalDB API 的程式碼範例,請參閱SQL Server Express LocalDB 參考。