Función LocalDBGetVersionInfo

Devuelve información para la versión de SQL Server Express LocalDB especificada, como si existe y el número de versión completo de LocalDB (incluidos los números de compilación y versión).

La información se devuelve en forma de localDBVersionInfostruct, que tiene la siguiente definición.

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;  
  

Archivo de encabezado: sqlncli.h

Sintaxis

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

Parámetros

wszVersionName
[Entrada] Nombre de la versión de LocalDB.

pVersionInfo
[Salida] Búfer para almacenar la información sobre la versión de LocalDB.

dwVersionInfoSize
[Entrada] Contiene el tamaño del búfer VersionInfo .

Devoluciones

S_OK
La función se ha realizado correctamente.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB no está instalado en el equipo.

LOCALDB_ERROR_INVALID_PARAMETER
Uno o varios parámetros de entrada especificados no son válidos.

LOCALDB_ERROR_UNKNOWN_VERSION
La versión de LocalDB especificada no existe.

LOCALDB_ERROR_INTERNAL_ERROR
Error inesperado. Consulte el registro de eventos para obtener más información.

Detalles

La justificación detrás de la introducción del struct argumento size (lpVersionInfoSize) es permitir que la API devuelva diferentes versiones de localDBVersionInfostruct, lo que permite de forma eficaz la compatibilidad con versiones anteriores y posteriores.

Si el struct argumento size (lpVersionInfoSize) coincide con el tamaño de una versión conocida de LocalDBVersionInfostruct, se devuelve esa versión de .struct De lo contrario, se devuelve LOCALDB_ERROR_INVALID_PARAMETER.

Un ejemplo típico del uso de la API LocalDBGetVersionInfo tiene este aspecto:

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

Observaciones

Para obtener un ejemplo de código que usa la API de LocalDB, consulte Referencia de SQL Server Express LocalDB.

Véase también

Información de versiones y encabezados de SQL Server Express LocalDB