Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Запускает указанный экземпляр SQL Server Express LocalDB.
Файл заголовка: sqlncli.h
Синтаксис
HRESULT LocalDBStartInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
LPWSTR wszSqlConnection,
LPDWORD lpcchSqlConnection
);
Параметры
pInstanceName
[Входные данные] Имя запускаемого экземпляра LocalDB.
dwFlags
[Входные данные] Зарезервировано для дальнейшего использования. В настоящее время должно быть установлено значение 0.
wszSqlConnection
[Выходные данные] Буфер для хранения строки подключения к экземпляру LocalDB.
lpcchSqlConnection
[входные и выходные данные] В входных данных содержится размер буфера wszSqlConnection в символах, включая все конечные значения NULL. Если заданный размер буфера слишком мал, в выходных данных содержится требуемый размер буфера в символах, включая все конечные значения NULL.
Возвраты
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_INSUFFICIENT_BUFFER
Указанный буфер wszSqlConnection слишком мал.
LOCALDB_ERROR_WAIT_TIMEOUT
Время ожидания произошло при попытке получить блокировки синхронизации.
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_CANNOT_MODIFY_INSTANCE_REGISTRY
Невозможно изменить реестр экземпляров.
LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
Невозможно создать процесс для SQL Server.
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Процесс SQL Server был запущен, но сбой запуска SQL Server.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Конфигурация экземпляра повреждена.
LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
Не удается создать автоматический экземпляр. Дополнительные сведения об ошибках см. в журнале событий приложения Windows.
LOCALDB_ERROR_INTERNAL_ERROR
Произошла непредвиденная ошибка. Дополнительные сведения см. в журнале событий.
Сведения
Аргумент буфера подключения (wszSqlConnection) и аргумент размера буфера подключения (lpcchSqlConnection) являются необязательными. В следующей таблице показаны параметры использования этих аргументов и их результатов.
| Буфер | Размер буфера | Логическое обоснование | Действие |
|---|---|---|---|
| Отсутствует | Отсутствует | Пользователь хочет запустить экземпляр и не требует имени канала. | Запускает экземпляр (без возврата канала и не требуется возвращать размер буфера). |
| Отсутствует | Присутствующий | Пользователь запрашивает размер выходного буфера. (В следующем вызове пользователь, вероятно, попросит фактического начала.) | Возвращает требуемый размер буфера (не запускается и не возвращается канал). Результатом является S_OK. |
| Присутствующий | Отсутствует | Запрещено; неверные входные данные. | Возвращенный результат LOCALDB_ERROR_INVALID_PARAMETER. |
| Присутствующий | Присутствующий | Пользователь хочет запустить экземпляр и должен подключиться к нему имя канала после его запуска. | Проверяет размер буфера, запускает экземпляр и возвращает имя канала в буфере. Аргумент размера буфера возвращает длину строки "server=", не включая завершающие значения NULL. |
Пример кода, использующий API LocalDB, см. в справочнике по SQL Server Express LocalDB.