Freigeben über


LocalDBGetInstances-Funktion

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

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

Die 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] Enthält 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.

Rückkehr

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 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. Details finden Sie im Ereignisprotokoll.

Bemerkungen

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

Siehe auch

SQL Server Express LocalDB-Header und Versionsinformationen