通过

LocalDBCreateInstance function

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

有关使用 LocalDB API 的代码示例，请参阅 SQL Server Express LocalDB 参考。

Related content