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 參考。