Функция 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.

Если ни один из флагов не задан, экземпляр 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_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
Произошла непредвиденная ошибка. Дополнительные сведения см. в журнале событий.

Замечания

Пример кода, использующий API LocalDB, см. в справочнике по SQL Server Express LocalDB.

См. также

Сведения о заголовке и версии SQL Server Express LocalDB