LocalDBCreateInstance 函数
适用于:SQL Server
创建新的 SQL Server Express LocalDB 实例。
头文件: msoledbsql.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。
如果现有实例损坏,则对 LocalDBCreateInstance API 方法的后续调用将失败。 必须手动修复损坏的实例或显式删除它们,然后才能再次使用。
有关使用 LocalDB API 的代码示例,请参阅 SQL Server Express LocalDB 参考。