Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Startet die angegebene SQL Server Express LocalDB-Instanz.
Headerdatei: sqlncli.h
Syntax
HRESULT LocalDBStartInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
LPWSTR wszSqlConnection,
LPDWORD lpcchSqlConnection
);
Die Parameter
pInstanceName
[Eingabe] Der Name der zu startenden LocalDB-Instanz.
dwFlags
[Eingabe] Reserviert für die zukünftige Verwendung. Derzeit sollte auf 0 festgelegt werden.
wszSqlConnection
[Ausgabe] Der Puffer zum Speichern der Verbindungszeichenfolge in der LocalDB-Instanz.
lpcchSqlConnection
[Eingabe/Ausgabe] Bei eingaben enthält die Größe des wszSqlConnection-Puffers in Zeichen, einschließlich der nachfolgenden NULL-Werte. Wenn die angegebene Puffergröße bei der Ausgabe zu klein ist, enthält die erforderliche Puffergröße in Zeichen, einschließlich der nachfolgenden NULL-Werte.
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_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 Versuch, die Synchronisierungssperren abzurufen, ist ein Timeout aufgetreten.
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_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 geändert 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 wurde beschädigt.
LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
Eine automatische Instanz kann nicht erstellt werden. Fehlerdetails finden Sie im Ereignisprotokoll der Windows-Anwendung.
LOCALDB_ERROR_INTERNAL_ERROR
Ein unerwarteter Fehler ist aufgetreten. Details finden Sie im Ereignisprotokoll.
Einzelheiten
Sowohl das Verbindungspufferargument (wszSqlConnection) als auch das Verbindungspuffergrößenargument (lpcchSqlConnection) sind optional. Die folgende Tabelle enthält Optionen für die Verwendung dieser Argumente und deren Ergebnisse.
| Puffer | Puffergröße | Grund | Maßnahme |
|---|---|---|---|
| NULL | NULL | Der Benutzer möchte die Instanz starten und benötigt keinen Pipenamen. | Startet eine Instanz (keine Piperückgabe und keine erforderliche Puffergröße). |
| NULL | Gegenwart | Der Benutzer fordert die Größe des Ausgabepuffers an. (Im nächsten Anruf fragt der Benutzer wahrscheinlich nach einem tatsächlichen Start.) | Gibt eine erforderliche Puffergröße zurück (kein Start und keine Piperückgabe). Das Ergebnis ist S_OK. |
| Gegenwart | NULL | Unstatthaft; falsche Eingabe. | Zurückgegebenes Ergebnis ist LOCALDB_ERROR_INVALID_PARAMETER. |
| Gegenwart | Gegenwart | Der Benutzer möchte die Instanz starten und benötigt den Pipenamen, um eine Verbindung mit der Instanz herzustellen, nachdem sie gestartet wurde. | Ü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, das die LocalDB-API verwendet, finden Sie in der SQL Server Express LocalDB-Referenz.