LocalDBGetInstances function

Applies to:SQL Server

Gibt alle SQL Server Express LocalDB-Instanzen mit der angegebenen Version zurück.

Header file:msoledbsql.h

Syntax

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName [ MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1 ] ;
typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames ,
           LPDWORD lpdwNumberOfInstances
);

Arguments

pInstanceNames

[Ausgabe] Wenn diese Funktion zurückgegeben wird, enthält sie die Namen der benannten und standardmäßigen LocalDB-Instanzen auf der Arbeitsstation des Benutzers.

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. Bei der Ausgabe enthält diese Option die Anzahl der LocalDB-Instanzen, die auf der Arbeitsstation des Benutzers gefunden wurden.

Returns

S_OK: Die Funktion war erfolgreich.

Error	Description
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_INSUFFICIENT_BUFFER	Der Eingabepuffer ist zu kurz und die Abkürzung wurde nicht angefordert.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG	Der Pfad, in dem die Instanz gespeichert werden soll, ist länger als MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY	Auf eine Instanzregistrierung kann nicht zugegriffen werden.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT	Eine Instanzkonfiguration ist beschädigt.
LOCALDB_ERROR_INTERNAL_ERROR	Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie im Ereignisprotokoll.

Remarks

Ein Codebeispiel, das die LocalDB-API verwendet, finden Sie unter SQL Server Express LocalDB-Referenz.

Related content

• SQL Server Express LocalDB-Header und Versionsinformationen