Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Applies to:
SQL Server
Создает новый экземпляр SQL Server Express LocalDB.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion ,
PCWSTR pInstanceName ,
DWORD dwFlags
);
Arguments
wszVersion
[Вход] Версия LocalDB, например 11.0 или 11.0.1094.2.
pInstanceName
[Вход] Имя создаваемого экземпляра LocalDB.
dwFlags
[Вход] Зарезервировано для использования в будущем. В настоящее время должно быть равным 0.
Returns
S_OK: функция завершилась успешно.
| Error | Description |
|---|---|
| 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 | Произошла непредвиденная ошибка. Подробные сведения см. в журнале событий. |
Remarks
Если полностью функциональный экземпляр LocalDB с указанным именем уже существует, и его версия равна или выше запрошенной, результатом является S_OK.
В случаях, когда существующий экземпляр становится поврежден, последующие вызовы метода API завершаются сбоем LocalDBCreateInstance . Поврежденный экземпляр необходимо исправить вручную или явно удалить, чтобы его можно было использовать снова.
Пример кода, использующий API LocalDB, см. в справочнике по SQL Server Express LocalDB.