傳回指定之版本的所有 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 參考>。