LocalDBGetVersionInfo-Funktion
Gibt Informationen zur angegebenen SQL Server Express-LocalDB-Version zurück, z. B., ob sie vorhanden ist sowie die vollständige LocalDB-Versionsnummer (inklusive Build- und Releasenummer).
Die Informationen werden in Form eines struct namens LocalDBVersionInfo zurückgegeben, der die folgende Definition aufweist.
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;
Headerdatei: sqlncli.h
Syntax
HRESULT LocalDBGetVersionInfo(
PCWSTR wszVersionName, PLocalDBVersionInfo pVersionInfo, DWORD dwVersionInfoSize);
Parameter
wszVersionName
[Eingabe] Der Name der LocalDB-Version.
pVersionInfo
[Ausgabe] Der Puffer zum Speichern der Informationen zur LocalDB-Version.
dwVersionInfoSize
[Eingabe] Enthält die Größe des VersionInfo-Puffers .
Gibt zurück
S_OK
Die Funktion wurde erfolgreich ausgeführt.
LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB ist nicht auf dem Computer installiert.
LOCALDB_ERROR_INVALID_PARAMETER
Mindestens ein angegebener Eingabeparameter ist ungültig.
LOCALDB_ERROR_UNKNOWN_VERSION
Die angegebene LocalDB-Version ist nicht vorhanden.
LOCALDB_ERROR_INTERNAL_ERROR
Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie im Ereignisprotokoll.
Informationen
Der Grund für die Einführung des structGrößenarguments (lpVersionInfoSize) besteht darin, der API zu ermöglichen, unterschiedliche Versionen der LocalDBVersionInfostruct zurückzugeben, wodurch effektiv Vorwärts- und Abwärtskompatibilität aktiviert wird.
Wenn das struct Size-Argument (lpVersionInfoSize) mit der Größe einer bekannten Version der LocalDBVersionInfostruct übereinstimmt, wird diese struct Version von zurückgegeben. Andernfalls wird LOCALDB_ERROR_INVALID_PARAMETER zurückgegeben.
Ein typisches Beispiel für die Verwendung der LocalDBGetVersionInfo-API sieht wie folgt aus:
LocalDBVersionInfo vi;
LocalDBVersionInfo(L"11.0", &vi, sizeof(LocalDBVersionInfo));
Bemerkungen
Ein Codebeispiel, in dem die LocalDB-API verwendet wird, finden Sie unter SQL Server Express LocalDB Reference.