Funzione LocalDBGetVersionInfo

Restituisce informazioni per la versione di SQL Server Express LocalDB specificata, ad esempio se esiste e il numero di versione localDB completo (inclusi i numeri di build e versione).

Le informazioni vengono restituite sotto forma di un struct denominato LocalDBVersionInfo, che ha la definizione seguente.

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 di intestazione: sqlncli.h

Sintassi

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

Parametri

wszVersionName
[Input] Nome della versione di LocalDB.

pVersionInfo
[Output] Buffer per archiviare le informazioni sulla versione di LocalDB.

dwVersionInfoSize
[Input] Contiene le dimensioni del buffer VersionInfo .

Restituzioni

S_OK
Funzione completata.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB non è installato nel computer.

LOCALDB_ERROR_INVALID_PARAMETER
Uno o più parametri di input specificati non sono validi.

LOCALDB_ERROR_UNKNOWN_VERSION
La versione specificata di LocalDB non esiste.

LOCALDB_ERROR_INTERNAL_ERROR
Errore imprevisto. Per informazioni dettagliate, vedere il registro eventi.

Dettagli

La logica alla base dell'introduzione dell'argomento size (lpVersionInfoSize) consiste nell'consentire struct all'API di restituire versioni diverse dello struct LocalDBVersionInfostruct, abilitando in modo efficace la compatibilità con le versioni precedenti e successive.

Se l'argomento struct size (lpVersionInfoSize) corrisponde alle dimensioni di una versione nota dellostruct LocalDBVersionInfostruct, viene restituita tale struct versione di . In caso contrario, viene restituito LOCALDB_ERROR_INVALID_PARAMETER.

Un esempio tipico di utilizzo dell'API LocalDBGetVersionInfo è simile al seguente:

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

Osservazioni:

Per un esempio di codice che usa l'API LocalDB, vedere Informazioni di riferimento su SQL Server Express LocalDB.

Vedere anche

Informazioni sull'intestazione e sulla versione di SQL Server Express LocalDB