共用方式為


LocalDBGetInstances 函式

適用於:SQL Server

傳回具有指定版本的所有 SQL Server Express LocalDB 實例。

頭檔: msoledbsql.h

語法

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef 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 標頭和版本資訊