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

另請參閱

SQL Server Express LocalDB 標頭和版本資訊