LocalDBGetVersionInfo function

Applies to:SQL Server

Retorna informações para a versão especificada do SQL Server Express LocalDB, como se ela existe e o número completo da versão do LocalDB (incluindo números de compilação e versão).

As informações são retornadas na forma de um struct nome LocalDBVersionInfo, que tem a seguinte definição.

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] O nome da versão do LocalDB.

pVersionInfo

[Realização] O buffer para armazenar as informações sobre a versão do LocalDB.

dwVersionInfoSize

[Input] Holds the size of the VersionInfo buffer.

Returns

S_OK: A função foi bem-sucedida.

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. Caso contrário, LOCALDB_ERROR_INVALID_PARAMETER é retornado.

Um exemplo típico de uso da LocalDBGetVersionInfo API tem esta aparência:

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

Remarks

Para obter um exemplo de código que usa a API LocalDB, consulte Referência do SQL Server Express LocalDB.

Related content

• Informações de cabeçalho e versão do SQL Server Express LocalDB