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

另請參閱

SQL Server Express LocalDB 標頭和版本資訊