LocalDBGetInstances 函数

返回具有给定版本的所有 SQL Server Express LocalDB 实例。

**头文件：**sqlncli.h

语法

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128
typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];
typedef TLocalDBInstanceName* PTLocalDBInstanceName;

HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames,
           LPDWORD lpdwNumberOfInstances
);

参数

• pInstanceNames
  [输出] 该函数返回时，将包含用户的工作站上命名的和默认的 LocalDB 实例的名称。

• lpdwNumberOfInstances
  [输入/输出] 输入时，将包含 pInstanceNames 缓冲区中实例名称的槽数。 输出时，包含在用户工作站上找到的 LocalDB 实例数。

返回

• S_OK
  函数成功。

• LOCALDB_ERROR_NOT_INSTALLED
  计算机上没有安装 SQL Server Express LocalDB。

• LOCALDB_ERROR_INVALID_PARAMETER
  一个或多个指定的输入参数无效。

• LOCALDB_ERROR_INSUFFICIENT_BUFFER
  输入的缓冲区太小，并且没有要求截断。

• LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
  应在其中存储该实例的路径的长度超过 MAX_PATH。

• LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
  无法访问实例注册表。

• LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
  实例配置已损坏。

• LOCALDB_ERROR_INTERNAL_ERROR
  发生了意外错误。 有关详细信息，请参阅事件日志。

注释

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

请参阅

概念

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