Compartir a través de

LocalDBGetVersionInfo function

Applies to:SQL Server

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

La información se devuelve en forma de , structLocalDBVersionInfoque 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;

Header file:msoledbsql.h

Syntax

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

Arguments

wszVersionName

[Entrada] El nombre de versión de LocalDB.

pVersionInfo

[Output] El búfer en el que se almacena información sobre la versión de LocalDB.

dwVersionInfoSize

[Input] Holds the size of the VersionInfo buffer.

Returns

S_OK: la función se realizó correctamente.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB no está instalado en el equipo.
LOCALDB_ERROR_INVALID_PARAMETER Uno o más 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 Se ha producido un error inesperado. Vea el registro de eventos para obtener detalles.

Details

The rationale behind the introduction of the struct size argument (lpVersionInfoSize) is to enable the API to return different versions of the LocalDBVersionInfostruct, effectively enabling forward and backward compatibility.

If the struct size argument (lpVersionInfoSize) matches the size of a known version of the LocalDBVersionInfostruct, that version of the struct is returned. En caso contrario, devuelve LOCALDB_ERROR_INVALID_PARAMETER.

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

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

Remarks

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

Related content

  • Last updated on