创建新的 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_SQL_SERVER_STARTUP_FAILED
SQL Server 进程已启动,但 SQL Server 启动失败。LOCALDB_ERROR_INTERNAL_ERROR
发生了意外错误。 有关详细信息,请参阅事件日志。
备注
如果 LocalDB 实例完全正常运行,指定的名称已存在并且其版本等于或高于所请求的版本,则结果为 S_OK。
在现有实例损坏的情况下,对 LocalDBCreateInstance API 方法的后续调用将失败。 必须手动修复损坏的实例或显式删除它们,然后才能再次使用。
有关使用 LocalDB API 的代码示例,请参阅 SQL Server Express LocalDB 参考。