Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse 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.