title | description | author | ms.author | ms.date | ms.service | ms.topic | apilocation | apiname | apitype |
---|---|---|---|---|---|---|---|---|---|
LocalDBStopInstance Function |
LocalDBStopInstance Function |
markingmyname |
maghan |
03/06/2017 |
sql |
reference |
sqluserinstance.dll |
LocalDBStopInstance |
DLLExport |
[!INCLUDE SQL Server] Stops the specified SQL Server Express LocalDB instance from running.
Header file: msoledbsql.h
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
ULONG ulTimeout
);
pInstanceName
[Input] The name of the LocalDB instance to stop.
dwFlags
[Input] One or a combination of the flag values specifying the way to stop the instance.
Available flags:
LOCALDB_SHUTDOWN_KILL_PROCESS
Shut down immediately using the kill process operating system command.
LOCALDB_SHUTDOWN_WITH_NOWAIT
Shut down using the WITH NOWAIT option Transact-SQL command.
If none of the flags is set, the LocalDB instance will be shut down using the SHUTDOWN Transact-SQL command. If both flags are set, the LOCALDB_SHUTDOWN_KILL_PROCESS flag takes precedence.
ulTimeout
[Input] The time in seconds to wait for this operation to complete. If this value is 0, this function will return immediately without waiting for the LocalDB instance to stop.
S_OK
The function succeeded.
LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB is not installed on the computer.
LOCALDB_ERROR_INVALID_PARAMETER
One or more specified input parameters are invalid.
LOCALDB_ERROR_INVALID_INSTANCE_NAME
The specified instance name is invalid.
LOCALDB_ERROR_UNKNOWN_INSTANCE
The instance does not exist.
LOCALDB_ERROR_WAIT_TIMEOUT
A time-out occurred while trying to acquire the synchronization locks.
LOCALDB_ERROR_INSTANCE_STOP_FAILED
The stop operation failed to complete within the given time.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
The path where the instance should be stored is longer than MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
A user profile folder cannot be retrieved.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
An instance folder cannot be accessed.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
An instance registry cannot be accessed.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
An instance configuration is corrupted.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER
API caller is not LocalDB instance owner.
LOCALDB_ERROR_INTERNAL_ERROR
An unexpected error occurred. See the event log for details.
For a code sample that uses LocalDB API, see SQL Server Express LocalDB Reference.