LocalDBStopInstance 函数

停止运行指定的 SQL Server Express LocalD 实例。

**头文件:**sqlncli.h

语法

HRESULT LocalDBStopInstance(
           PCWSTR pInstanceName,
           DWORD dwFlags, 
           ULONG ulTimeout 
);

参数

  • pInstanceName
    [输入] 要停止的 LocalDB 实例的名称。

  • dwFlags
    [输入] 指定要停止该实例的方法的一个标志或标志组合。

    可用标志:

    • LOCALDB_SHUTDOWN_KILL_PROCESS
      使用终止进程操作系统命令立即关闭。

    • LOCALDB_SHUTDOWN_WITH_NOWAIT
      使用 Transact-SQL 命令 WITH NOWAIT 选项关闭。

    如果没有设置标志,则使用 Transact-SQL 命令 SHUTDOWN 关闭 LocalDB 实例。 如果同时设置了这两个标志,则优先使用 LOCALDB_SHUTDOWN_KILL_PROCESS 标志。

  • ulTimeout
    [输入] 等待此操作完成的时间(秒)。 如果该值为 0,此函数将立即返回,而不等待 LocalDB 实例停止。

返回

注释

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

请参阅

概念

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