傳回指定之 SQL Server Express LocalDB 版本的資訊,例如此版本是否存在,以及完整的 LocalDB 版本號碼 (包括組建和發行版本號碼)。
此資訊會以名為 LocalDBVersionInfo 的 struct 形式傳回,其定義如下。
typedef struct _LocalDBVersionInfo
{
// Contains the size of the LocalDBVersionInfo struct
DWORD cbLocalDBVersionInfoSize;
// Holds the version name
TLocalDBVersionwszVersion;
// TRUE if the instance files exist on disk, FALSE otherwise
BOOL bExists;
// Holds the LocalDB version for the instance in the format: major.minor.build.revision
DWORD dwMajor;
DWORD dwMinor;
DWORD dwBuild;
DWORD dwRevision;
} LocalDBVersionInfo;
**標頭檔:**sqlncli.h
語法
HRESULT LocalDBGetVersionInfo(
PCWSTR wszVersionName,
PLocalDBVersionInfo pVersionInfo,
DWORD dwVersionInfoSize
);
參數
wszVersionName
[輸入] LocalDB 版本名稱。pVersionInfo
[輸出] 儲存 LocalDB 版本資訊的緩衝區。dwVersionInfoSize
[輸入] 保存 VersionInfo 緩衝區的大小。
傳回值
S_OK
此函數已成功。LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB 未安裝在電腦上。LOCALDB_ERROR_INVALID_PARAMETER
一個或多個指定的輸入參數無效。LOCALDB_ERROR_UNKNOWN_VERSION
指定的 LocalDB 版本不存在。LOCALDB_ERROR_INTERNAL_ERROR
發生意外的錯誤。 請參閱事件記錄檔,以取得詳細資料。
詳細資料
導入 struct 大小引數 (lpVersionInfoSize) 背後的基本原理,是為了讓 API 傳回 LocalDBVersionInfo struct 的不同版本,以有效地啟用新舊版相容性。
如果 struct 大小引數 (lpVersionInfoSize) 符合 LocalDBVersionInfo struct 已知版本的大小,則會傳回該版本的 struct。 否則會傳回 LOCALDB_ERROR_INVALID_PARAMETER。
LocalDBVersionInfo API 使用方式的典型範例如下所示:
LocalDBVersionInfo vi;
LocalDBVersionInfo(L”11.0”, &vi, sizeof(LocalDBVersionInfo));
備註
如需使用 LocalDB API 的程式碼範例,請參閱<SQL Server Express LocalDB 參考>。