LocalDBGetVersionInfo 函數
傳回指定之 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
發生意外錯誤。 請參閱事件記錄檔,以取得詳細資料。
詳細資料
(lpVersionInfoSize) 引進 struct
size 引數背後的理由是讓 API 傳回不同版本的LocalDBVersionInfostruct,有效地啟用向前和回溯相容性。
struct
如果 size 引數 (lpVersionInfoSize) 符合LocalDBVersionInfostruct已知版本的大小,則會傳回該版本的 struct
。 否則會傳回 LOCALDB_ERROR_INVALID_PARAMETER。
LocalDBGetVersionInfo API 使用方式的典型範例如下所示:
LocalDBVersionInfo vi;
LocalDBVersionInfo(L"11.0", &vi, sizeof(LocalDBVersionInfo));
備註
如需使用 LocalDB API 的程式碼範例,請參閱SQL Server Express LocalDB 參考。