LocalDBStopInstance 函式

適用於：SQL Server

停止指定的 SQL Server Express LocalDB 實例執行。

標頭檔： msoledbsql.h

語法

HRESULT LocalDBStopInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           ULONG ulTimeout   
);

pInstanceName
[輸入]要停止的 LocalDB 實例名稱。

dwFlags
[輸入]旗標值的其中一個或組合，指定停止實例的方式。

可用的旗標：

LOCALDB_SHUTDOWN_KILL_PROCESS
使用 kill process 作業系統命令立即關閉。

LOCALDB_SHUTDOWN_WITH_NOWAIT
使用 WITH NOWAIT 選項 Transact-SQL 命令關閉。

如果未設定任何旗標，LocalDB 實例將會使用 SHUTDOWN Transact-SQL 命令關閉。如果同時設定這兩個旗標，則LOCALDB_SHUTDOWN_KILL_PROCESS旗標優先。

ulTimeout
[輸入]等候此作業完成的秒數。如果此值為 0，此函式會立即傳回，而不需要等待 LocalDB 實例停止。

S_OK
此函數已成功。

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

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

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

LOCALDB_ERROR_INSTANCE_STOP_FAILED
停止作業無法在指定時間內完成。

LOCALDB_ERROR_CALLER_IS_NOT_OWNER
API 呼叫端不是 LocalDB 實例擁有者。

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

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