Fungsi LocalDBGetVersionInfo

Mengembalikan informasi untuk versi SQL Server Express LocalDB yang ditentukan, seperti apakah ada dan nomor versi LocalDB lengkap (termasuk nomor build dan rilis).

Informasi dikembalikan dalam bentuk structLocalDBVersionInfo bernama, yang memiliki definisi berikut.

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;  
  

File header: sqlncli.h

Sintaksis

HRESULT LocalDBGetVersionInfo(  
           PCWSTR wszVersionName,           PLocalDBVersionInfo pVersionInfo,           DWORD dwVersionInfoSize);  

Parameter-parameternya

wszVersionName
[Input] Nama versi LocalDB.

pVersionInfo
[Output] Buffer untuk menyimpan informasi tentang versi LocalDB.

dwVersionInfoSize
[Input] Menyimpan ukuran buffer VersionInfo .

Pengembalian Barang

S_OK
Fungsi berhasil.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB tidak diinstal pada komputer.

LOCALDB_ERROR_INVALID_PARAMETER
Satu atau beberapa parameter input yang ditentukan tidak valid.

LOCALDB_ERROR_UNKNOWN_VERSION
Versi LocalDB yang ditentukan tidak ada.

LOCALDB_ERROR_INTERNAL_ERROR
Terjadi kesalahan tak terduga. Lihat log peristiwa untuk detailnya.

Detail lebih lanjut

Alasan di balik pengenalan struct argumen ukuran (lpVersionInfoSize) adalah untuk memungkinkan API mengembalikan versi yang berbeda dari LocalDBVersionInfostruct, secara efektif memungkinkan kompatibilitas maju dan mundur.

struct Jika argumen ukuran (lpVersionInfoSize) cocok dengan ukuran versi LocalDBVersionInfostruct yang diketahui, versi struct tersebut dikembalikan. Jika tidak, LOCALDB_ERROR_INVALID_PARAMETER dikembalikan.

Contoh umum penggunaan API LocalDBGetVersionInfo terlihat seperti ini:

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

Komentar

Untuk sampel kode yang menggunakan API LocalDB, lihat Referensi SQL Server Express LocalDB.

Lihat Juga

Informasi Header dan Versi SQL Server Express LocalDB