LocalDBStopInstance-Funktion

Beendet die Ausführung der angegebenen SQL Server Express LocalDB-Instanz.

Headerdatei: sqlncli.h

Syntax

HRESULT LocalDBStopInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           ULONG ulTimeout   
);  

Die Parameter

pInstanceName
[Eingabe] Der Name der localDB-Instanz, die beendet werden soll.

dwFlags
[Eingabe] Eine oder eine Kombination der Flagwerte, die die Möglichkeit zum Beenden der Instanz angeben.

Verfügbare Flags:

LOCALDB_SHUTDOWN_KILL_PROCESS
Fahren Sie sofort mit dem Befehl "Kill Process Operating System" 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 Befehl SHUTDOWN Transact-SQL heruntergefahren. Wenn beide Flags festgelegt sind, hat das LOCALDB_SHUTDOWN_KILL_PROCESS Flag Vorrang.

ulTimeout
[Eingabe] Die Zeit in Sekunden, bis dieser Vorgang abgeschlossen ist. Wenn dieser Wert 0 ist, wird diese Funktion sofort zurückgegeben, ohne darauf zu warten, dass die LocalDB-Instanz beendet wird.

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_WAIT_TIMEOUT
Beim Versuch, die Synchronisierungssperren abzurufen, ist ein Timeout aufgetreten.

LOCALDB_ERROR_INSTANCE_STOP_FAILED
Der Stoppvorgang konnte innerhalb des angegebenen Zeitraums nicht abgeschlossen werden.

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. 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