指定した SQL Server Express LocalDB インスタンスの実行を停止します。
ヘッダー ファイル: sqlncli.h
構文
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
ULONG ulTimeout
);
パラメーター
pInstanceName
[入力]停止する LocalDB インスタンスの名前。
dwFlags
[入力]インスタンスを停止する方法を指定するフラグ値の 1 つまたは組み合わせ。
使用可能なフラグ:
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
1 つ以上の指定された入力パラメーターが無効です。
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 リファレンス」を参照してください。