LocalDBGetVersionInfo 函式
適用於：
SQL Server
傳回指定之 SQL Server Express LocalDB 版本的資訊，例如是否存在，以及完整的 LocalDB 版本號碼（包括組建和發行編號）。
資訊會以名為 LocalDBVersionInfo 的結構形式傳回，其定義如下。
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;
頭檔： msoledbsql.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
發生未預期的錯誤。 如需詳細資訊，請參閱事件記錄檔。
詳細資料
引進 結構 大小自變數 （lpVersionInfoSize） 背後的原理，是讓 API 能夠傳回不同版本的 LocalDBVersionInfostruct，有效地啟用向前和回溯相容性。
如果 struct size 自變數 （lpVersionInfoSize） 符合 LocalDBVersionInfostruct 的已知版本大小，則會傳回該版本的結構。 否則會傳回LOCALDB_ERROR_INVALID_PARAMETER。
LocalDBGetVersionInfo API 使用方式的一般范例如下所示：
LocalDBVersionInfo vi;
LocalDBVersionInfo(L"11.0", &vi, sizeof(LocalDBVersionInfo));
備註
如需使用 LocalDB API 的程式碼範例，請參閱 SQL Server Express LocalDB 參考。