LocalDBCreateInstance 函数

适用于:yesSQL Server (支持的所有)

创建新的 SQL Server Express LocalDB 实例。

头文件: sqlncli.h

语法

HRESULT LocalDBCreateInstance(  
           PCWSTR wszVersion,  
           PCWSTR pInstanceName,   
           DWORD dwFlags   
);  

parameters

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 方法的后续调用将失败。 必须手动修复损坏的实例或显式删除它们,然后才能再次使用。

有关使用 API 的代码LocalDB,请参阅 SQL Server Express LocalDB 参考

另请参阅

SQL Server Express LocalDB 标头信息和版本信息