Функция LocalDBCreateInstance

Создает новый экземпляр 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

См. также

Основные понятия

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