LocalDBGetInstances-Funktion

Artikel
01/02/2025

Gilt für: SQL Server

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

Headerdatei: 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  
);

Parameter

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
[Eingabe/Ausgabe] Bei Eingabe enthält dieses Objekt die Anzahl der Slots für Instanznamen im pInstanceNames -Puffer. Enthält auf der Ausgabe die Anzahl der LocalDB-Instanzen, die auf der Arbeitsstation des Benutzers gefunden wurden.

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_INSUFFICIENT_BUFFER
Der Eingabepuffer ist zu kurz. Abschneiden wurde nicht angefordert.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
Der Pfad, unter 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.

Hinweise

Ein Codebeispiel, in dem die LocalDB-API verwendet wird, finden Sie unter SQL Server Express LocalDB Reference.

Weitere Informationen

SQL Server Express LocalDB-Header und -Versionsinformationen

Freigeben über