共用方式為


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 緩衝區的大小。

傳回值

詳細資料

導入 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 參考>。

請參閱

概念

SQL Server Express LocalDB 標頭和版本資訊