Funzione LocalDBGetVersionInfo

Articolo
07/04/2024

Si applica a: SQL Server

Vengono restituite le informazioni per la versione del database locale di SQL Server Express specificata, se esistente, e il numero completo della versione del database locale, ovvero con i numeri di compilazione e della versione inclusi.

Le informazioni vengono restituite sotto forma di uno 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: msoledbsql.h

Sintassi

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

Parametri

wszVersionName
[Input] Nome della versione del database locale.

pVersionInfo
[Output] Buffer per archiviare le informazioni sulla versione del database locale.

dwVersionInfoSize
[Input] Contiene le dimensioni del buffer VersionInfo .

Valori restituiti

S_OK
Funzione completata.

LOCALDB_ERROR_NOT_INSTALLED
Database locale di SQL Server Express non installato nel computer.

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

LOCALDB_ERROR_UNKNOWN_VERSION
La versione del database locale specificata non esiste.

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

Dettagli

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

Se l'argomento dimensioni dello struct (lpVersionInfoSize) corrisponde alle dimensioni di una versione nota dello struct LocalDBVersionInfostruct, viene restituita tale versione dello struct. 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.

Vedi anche

Informazioni sulla versione e intestazione di SQL Server Express LocalDB

Condividi tramite