Delen via

LocalDBStopInstance function

Applies to:SQL Server

Hiermee wordt het opgegeven SQL Server Express LocalDB-exemplaar niet meer uitgevoerd.

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

[Invoer] De naam van het LocalDB-exemplaar dat moet worden gestopt.

dwFlags

[Invoer] Een of een combinatie van de vlagwaarden waarmee de manier wordt opgegeven om het exemplaar te stoppen.

Available flags:

LOCALDB_SHUTDOWN_KILL_PROCESS

Sluit onmiddellijk af met behulp van de opdracht voor het beëindigen van het besturingssysteem.

LOCALDB_SHUTDOWN_WITH_NOWAIT

Sluit de WITH NOWAIT optie Transact-SQL opdracht af.

Als geen van de vlaggen is ingesteld, wordt het LocalDB-exemplaar afgesloten met behulp van de SHUTDOWN opdracht Transact-SQL. Als beide vlaggen zijn ingesteld, heeft de LOCALDB_SHUTDOWN_KILL_PROCESS vlag voorrang.

ulTimeout

[Invoer] De tijd in seconden om te wachten tot deze bewerking is voltooid. Als deze waarde is 0, retourneert deze functie onmiddellijk zonder te wachten totdat het LocalDB-exemplaar is gestopt.

Returns

S_OK: De functie is geslaagd.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB is niet geïnstalleerd op de computer.
LOCALDB_ERROR_INVALID_PARAMETER Een of meer opgegeven invoerparameters zijn ongeldig.
LOCALDB_ERROR_INVALID_INSTANCE_NAME De opgegeven exemplaarnaam is ongeldig.
LOCALDB_ERROR_UNKNOWN_INSTANCE Het exemplaar bestaat niet.
LOCALDB_ERROR_WAIT_TIMEOUT Er is een time-out opgetreden tijdens het verkrijgen van de synchronisatievergrendelingen.
LOCALDB_ERROR_INSTANCE_STOP_FAILED De stopbewerking kan niet binnen de opgegeven tijd worden voltooid.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Het pad waar het exemplaar moet worden opgeslagen, is langer dan MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER Een gebruikersprofielmap kan niet worden opgehaald.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER Er kan geen exemplaarmap worden geopend.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Er kan geen exemplaarregister worden geopend.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Een exemplaarconfiguratie is beschadigd.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER Api-aanroeper is geen eigenaar van het LocalDB-exemplaar.
LOCALDB_ERROR_INTERNAL_ERROR Er is een onverwachte fout opgetreden. Zie het gebeurtenislogboek voor meer informatie.

Remarks

Zie sql Server Express LocalDB-referentie voor een codevoorbeeld dat gebruikmaakt van de LocalDB-API van LocalDB.

Related content