Функция LocalDBGetVersionInfo

Возвращает сведения о указанной версии SQL Server Express LocalDB, например о том, существует ли она, и полный номер версии LocalDB (включая номера сборки и выпуска).

Сведения возвращаются в виде именованного structLocalDBVersionInfo, имеющего следующее определение.

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
Произошла непредвиденная ошибка. Дополнительные сведения см. в журнале событий.

Сведения

Обоснование внедрения аргумента struct размера (lpVersionInfoSize) заключается в том, чтобы API возвращал различные версии структуры LocalDBVersionInfoinfo, эффективно обеспечивая обратную и обратную совместимость.

struct Если аргумент размера (lpVersionInfoSize) соответствует размеру известной версии localDBVersionInfostruct, возвращается эта версияstruct. В противном случае возвращается LOCALDB_ERROR_INVALID_PARAMETER.

Типичный пример использования API LocalDBGetVersionInfo выглядит следующим образом:

LocalDBVersionInfo vi;  
LocalDBVersionInfo(L"11.0", &vi, sizeof(LocalDBVersionInfo));  
  

Замечания

Пример кода, использующий API LocalDB, см. в справочнике по SQL Server Express LocalDB.

См. также

Сведения о заголовке и версии SQL Server Express LocalDB