Applies to:
SQL Server
返回具有给定版本的所有 SQL Server Express LocalDB 实例。
Header file:msoledbsql.h
Syntax
#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName [ MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1 ] ;
typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
PTLocalDBInstanceName pInstanceNames ,
LPDWORD lpdwNumberOfInstances
);
Arguments
pInstanceNames
[输出]当此函数返回时，包含用户工作站上命名实例和默认 LocalDB 实例的名称。
lpdwNumberOfInstances
[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. 在输出中，此选项包含用户工作站上发现的 LocalDB 实例数。
Returns
S_OK：函数成功。
| Error | Description |
|---|---|
| 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 | 发生了意外错误。 有关详细信息，请参阅事件日志。 |
Remarks
有关使用 LocalDB API 的代码示例，请参阅 SQL Server Express LocalDB 参考。