Dela via

LocalDBStopInstance function

Applies to:SQL Server

Hindrar den angivna SQL Server Express LocalDB-instansen från att köras.

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

[Indata] Namnet på den LocalDB-instans som ska stoppas.

dwFlags

[Indata] En eller en kombination av flaggvärdena som anger hur instansen ska stoppas.

Available flags:

LOCALDB_SHUTDOWN_KILL_PROCESS

Stäng av omedelbart med kommandot avsluta processoperativsystem.

LOCALDB_SHUTDOWN_WITH_NOWAIT

Stäng av med hjälp av WITH NOWAIT alternativet Transact-SQL kommando.

Om ingen av flaggorna har angetts stängs LocalDB-instansen SHUTDOWN av med kommandot Transact-SQL. Om båda flaggorna LOCALDB_SHUTDOWN_KILL_PROCESS anges har flaggan företräde.

ulTimeout

[Indata] Tiden i sekunder att vänta tills åtgärden har slutförts. Om det här värdet är 0returnerar den här funktionen omedelbart utan att vänta på att LocalDB-instansen ska stoppas.

Returns

S_OK: Funktionen lyckades.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB är inte installerat på datorn.
LOCALDB_ERROR_INVALID_PARAMETER En eller flera angivna indataparametrar är ogiltiga.
LOCALDB_ERROR_INVALID_INSTANCE_NAME Det angivna instansnamnet är ogiltigt.
LOCALDB_ERROR_UNKNOWN_INSTANCE Instansen finns inte.
LOCALDB_ERROR_WAIT_TIMEOUT En timeout inträffade när synkroniseringslåsen skulle hämtas.
LOCALDB_ERROR_INSTANCE_STOP_FAILED Stoppåtgärden kunde inte slutföras inom den angivna tiden.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Sökvägen där instansen ska lagras är längre än MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER Det går inte att hämta en användarprofilmapp.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER Det går inte att komma åt en instansmapp.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Det går inte att komma åt ett instansregister.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT En instanskonfiguration är skadad.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER API-anroparen är inte LocalDB-instansägare.
LOCALDB_ERROR_INTERNAL_ERROR Ett oväntat fel uppstod. Mer information finns i händelseloggen.

Remarks

Ett kodexempel som använder LocalDB API finns i SQL Server Express LocalDB-referens.

Related content