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.
Applies to:
SQL Server
Beendet die angegebene SQL Server Express LocalDB-Instanz.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName ,
DWORD dwFlags ,
ULONG ulTimeout
);
Arguments
pInstanceName
[Eingabe] Der Name der LocalDB-Instanz, die angehalten werden soll.
dwFlags
[Eingabe] Ein Flagwert oder eine Kombination der Flagwerte, die den Weg zum Beenden der Instanz angibt.
Available flags:
LOCALDB_SHUTDOWN_KILL_PROCESS
Fahren Sie sofort mit dem Befehl "Beenden des Prozesses" des Betriebssystems herunter.
LOCALDB_SHUTDOWN_WITH_NOWAIT
Fahren Sie mit der WITH NOWAIT Option Transact-SQL Befehl herunter.
Wenn keines der Flags festgelegt ist, wird die LocalDB-Instanz mit dem SHUTDOWN Befehl Transact-SQL heruntergefahren. Wenn beide Flags festgelegt sind, hat die LOCALDB_SHUTDOWN_KILL_PROCESS Kennzeichnung Vorrang.
ulTimeout
[Eingabe] Die Wartezeit in Sekunden, bis dieser Vorgang abgeschlossen ist. Wenn dieser Wert lautet 0, wird diese Funktion sofort zurückgegeben, ohne darauf zu warten, dass die LocalDB-Instanz beendet wird.
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_INVALID_INSTANCE_NAME | Der angegebene Instanzname ist ungültig. |
| LOCALDB_ERROR_UNKNOWN_INSTANCE | Die Instanz ist nicht vorhanden. |
| LOCALDB_ERROR_WAIT_TIMEOUT | Beim versuchten Abrufen der Synchronisierungssperren ist ein Timeout aufgetreten. |
| LOCALDB_ERROR_INSTANCE_STOP_FAILED | Der Beendigungsvorgang wurde nicht innerhalb der angegebenen Zeit abgeschlossen. |
| 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_INSTANCE_CONFIGURATION_CORRUPT | Eine Instanzkonfiguration ist beschädigt. |
| LOCALDB_ERROR_CALLER_IS_NOT_OWNER | DER API-Aufrufer ist kein LocalDB-Instanzbesitzer. |
| 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.