Sdílet prostřednictvím

LocalDBStopInstance function

Applies to:SQL Server

Zastaví spuštění zadané instance SQL Server Express LocalDB.

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

[Vstup] Název instance LocalDB, která se má zastavit.

dwFlags

[Vstup] Jedna nebo kombinace hodnot příznaku určující způsob zastavení instance.

Available flags:

LOCALDB_SHUTDOWN_KILL_PROCESS

Okamžitě ukončete příkaz operačního systému ukončete.

LOCALDB_SHUTDOWN_WITH_NOWAIT

Vypnutí pomocí WITH NOWAIT příkazu Transact-SQL možnosti

Pokud není nastaven žádný z příznaků, instance LocalDB se vypne pomocí SHUTDOWN příkazu Transact-SQL. Pokud jsou nastavené oba příznaky, LOCALDB_SHUTDOWN_KILL_PROCESS má příznak přednost.

ulTimeout

[Vstup] Doba v sekundách čekání na dokončení této operace. Pokud je 0tato hodnota, vrátí tato funkce okamžitě, aniž by čekala na zastavení instance LocalDB.

Returns

S_OK: Funkce byla úspěšná.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB není v počítači nainstalovaný.
LOCALDB_ERROR_INVALID_PARAMETER Jeden nebo více zadaných vstupních parametrů je neplatný.
LOCALDB_ERROR_INVALID_INSTANCE_NAME Zadaný název instance je neplatný.
LOCALDB_ERROR_UNKNOWN_INSTANCE Instance neexistuje.
LOCALDB_ERROR_WAIT_TIMEOUT Při pokusu o získání zámků synchronizace došlo k vypršení časového limitu.
LOCALDB_ERROR_INSTANCE_STOP_FAILED Operaci zastavení se nepodařilo dokončit v daném čase.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Cesta, ve které má být instance uložena, je delší než MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER Složku profilu uživatele nelze načíst.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER Nelze získat přístup ke složce instance.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Nelze získat přístup k registru instance.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Konfigurace instance je poškozena.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER Volající rozhraní API není vlastníkem instance LocalDB.
LOCALDB_ERROR_INTERNAL_ERROR Došlo k neočekávané chybě. Podrobnosti najdete v protokolu událostí.

Remarks

Ukázku kódu, která používá rozhraní LocalDB API, najdete v referenčních informacích k SQL Serveru Express LocalDB.

Related content

  • Last updated on