Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Создает новый экземпляр SQL Server Express LocalDB.
Файл заголовка: sqlncli.h
Синтаксис
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion,
PCWSTR pInstanceName,
DWORD dwFlags
);
Параметры
wszVersion
[Входные данные] Версия LocalDB, например 11.0 или 11.0.1094.2.
pInstanceName
[Входные данные] Имя создаваемого экземпляра LocalDB.
dwFlags
[Входные данные] Зарезервировано для дальнейшего использования. В настоящее время должно быть установлено значение 0.
Возвраты
S_OK
Функция завершилась успешно.
LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB не установлен на компьютере.
LOCALDB_ERROR_INVALID_PARAMETER
Один или несколько указанных входных параметров недопустимы.
LOCALDB_ERROR_INVALID_INSTANCE_NAME
Указанное имя экземпляра недопустимо.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
Путь, в котором должен храниться экземпляр, превышает MAX_PATH.
LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
Указанный экземпляр уже существует, но его версия ниже запрошенной.
LOCALDB_ERROR_UNKNOWN_VERSION
Указанная версия недоступна.
LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
Указанный уровень исправлений не установлен.
LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
Не удается создать папку в %userprofile%.
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_SQL_SERVER_STARTUP_FAILED
Процесс SQL Server запущен, но сбой запуска SQL Server.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Конфигурация экземпляра повреждена.
LOCALDB_ERROR_INTERNAL_ERROR
Произошла непредвиденная ошибка. Дополнительные сведения см. в журнале событий.
Замечания
Если полностью функциональный экземпляр LocalDB с указанным именем уже существует и его версия равна или выше запрошенной, результат будет S_OK.
В случаях, когда существующий экземпляр поврежден, последующие вызовы метода API завершаются ошибкой LocalDBCreateInstance . Поврежденные экземпляры должны быть исправлены вручную или явно удалены, прежде чем их можно будет снова использовать.
Пример кода, использующий API LocalDB, см. в справочнике по SQL Server Express LocalDB.