Поделиться через

LocalDBStopInstance function

Applies to:SQL Server

Останавливает указанный запущенный экземпляр SQL Server Express LocalDB.

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

[Вход] Имя останавливаемого экземпляра LocalDB.

dwFlags

[Вход] Значение или сочетание значений флагов, задающее способ остановки экземпляра.

Available flags:

LOCALDB_SHUTDOWN_KILL_PROCESS

Немедленно завершите работу с помощью команды операционной системы завершения процесса.

LOCALDB_SHUTDOWN_WITH_NOWAIT

Завершение работы с помощью WITH NOWAIT команды Transact-SQL.

Если ни один из флагов не задан, экземпляр LocalDB завершит работу с помощью SHUTDOWN команды Transact-SQL. Если заданы оба флага, LOCALDB_SHUTDOWN_KILL_PROCESS флаг имеет приоритет.

ulTimeout

[Вход] Время ожидания выполнения операции в секундах. Если это значение, 0эта функция возвращается немедленно, не ожидая остановки экземпляра LocalDB.

Returns

S_OK: функция завершилась успешно.

Error Description
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 Произошла непредвиденная ошибка. Подробные сведения см. в журнале событий.

Remarks

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

Related content

  • Last updated on