LocalDBStartInstance-Funktion

Artikel
01/02/2025

Gilt für: SQL Server

Startet die angegebene SQL Server Express LocalDB-Instanz.

Headerdatei: msoledbsql.h

Syntax

HRESULT LocalDBStartInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           LPWSTR wszSqlConnection,   
           LPDWORD lpcchSqlConnection   
);

Parameter

pInstanceName
[Eingabe] Der Name der LocalDB-Instanz, die gestartet werden soll.

dwFlags
[Eingabe] Zur künftigen Verwendung reserviert. Muss derzeit auf 0 festgelegt sein.

wszSqlConnection
[Ausgabe] Der Puffer zum Speichern der Verbindungszeichenfolge in der LocalDB-Instanz.

lpcchSqlConnection
[Eingabe/Ausgabe] Bei Eingabe enthält dieses Objekt die Größe des wszSqlConnection -Puffers in Zeichen, einschließlich sämtlicher nachfolgender Nullen. Wenn der angegebene Puffer zu klein ist, enthält dieses Objekt bei Ausgabe die erforderliche Puffergröße in Zeichen, einschließlich sämtlicher nachfolgender Nullen.

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_INVALID_INSTANCE_NAME
Der angegebene Instanzname ist ungültig.

LOCALDB_ERROR_UNKNOWN_INSTANCE
Die Instanz ist nicht vorhanden.

LOCALDB_ERROR_INSUFFICIENT_BUFFER
Der angegebene Puffer wszSqlConnection ist zu klein.

LOCALDB_ERROR_WAIT_TIMEOUT
Beim versuchten Abrufen der Synchronisierungssperren ist ein Timeout aufgetreten.

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_GET_USER_PROFILE_FOLDER
Ein Benutzerprofilordner kann nicht abgerufen werden.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
Auf einen Instanzordner kann nicht zugegriffen werden.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
Auf eine Instanzregistrierung kann nicht zugegriffen werden.

LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
Eine Instanzregistrierung kann nicht bearbeitet werden.

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
Ein Prozess für SQL Server kann nicht erstellt werden.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Ein SQL Server-Prozess wurde gestartet, der SQL Server-Start ist jedoch fehlgeschlagen.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Eine Instanzkonfiguration war beschädigt.

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
Kann keine automatische Instanz erstellen. Fehlerdetails finden Sie im Windows-Anwendungsereignisprotokoll.

LOCALDB_ERROR_INTERNAL_ERROR
Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie im Ereignisprotokoll.

Details

Das Verbindungspufferargument (wszSqlConnection) und das Verbindungspuffergrößen-Argument (lpcchSqlConnection) sind optional. In der folgenden Tabelle werden Optionen zum Verwenden dieser Argumente und ihrer Ergebnisse angezeigt.

Buffer	Puffergröße	Sinn	Aktion
NULL	NULL	Der Benutzer möchte die Instanz starten und benötigt keinen Pipenamen.	Startet eine Instanz (keine Piperückgabe und keine erforderliche Puffergrößenrückgabe).
NULL	Vorhanden	Benutzer fragt nach der Ausgabepuffergröße. (Im nächsten Aufruf bittet der Benutzer wahrscheinlich um einen tatsächlichen Start.)	Gibt eine erforderliche Puffergröße (kein Start und keine Piperückgabe) zurück. Ergebnis ist S_OK.
Vorhanden	NULL	Nicht zulässig; falsche Eingabe.	Das zurückgegebene Ergebnis ist LOCALDB_ERROR_INVALID_PARAMETER.
Vorhanden	Vorhanden	Der Benutzer möchte die Instanz starten und benötigt den Pipenamen, zu dem nach dem Start eine Verbindung hergestellt wird.	Überprüft die Puffergröße, startet die Instanz und gibt den Pipenamen im Puffer zurück. Das Argument für die Puffergröße gibt die Länge der Zeichenfolge "server=" zurück, ohne null zu beenden.

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