LocalDBStopInstance function

Applies to:SQL Server

Viene arrestata l'esecuzione dell'istanza del database locale di SQL Server Express specificata.

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

[Input] Nome dell'istanza del database locale da arrestare.

dwFlags

[Input] Uno o una combinazione di valori per i flag che specificano la modalità di arresto dell'istanza.

Available flags:

LOCALDB_SHUTDOWN_KILL_PROCESS

Arrestare immediatamente usando il comando termina il sistema operativo del processo.

LOCALDB_SHUTDOWN_WITH_NOWAIT

Arrestare usando l'opzione WITH NOWAIT Transact-SQL comando .

Se nessuno dei flag è impostato, l'istanza di LocalDB verrà arrestata usando il SHUTDOWN comando Transact-SQL. Se vengono impostati entrambi i flag, il flag ha la LOCALDB_SHUTDOWN_KILL_PROCESS precedenza.

ulTimeout

[Input] Ora in secondi di attesa per il completamento di questa operazione. Se questo valore è 0, questa funzione restituirà immediatamente senza attendere l'arresto dell'istanza di LocalDB.

Returns

S_OK: la funzione ha avuto esito positivo.

Error	Description
LOCALDB_ERROR_NOT_INSTALLED	SQL Server Express LocalDB non è installato nel computer.
LOCALDB_ERROR_INVALID_PARAMETER	Uno o più parametri di input specificati non validi.
LOCALDB_ERROR_INVALID_INSTANCE_NAME	Nome dell'stanza specificata non valido.
LOCALDB_ERROR_UNKNOWN_INSTANCE	L'istanza non esiste.
LOCALDB_ERROR_WAIT_TIMEOUT	Timeout durante il tentativo di acquisizione dei blocchi di sincronizzazione.
LOCALDB_ERROR_INSTANCE_STOP_FAILED	Errore durante il completamento dell'operazione di arresto entro l'ora specificata.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG	Il percorso in cui l'istanza deve essere archiviata è più lunga di MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER	Non è possibile recuperare una cartella del profilo utente.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER	Non è possibile accedere a una cartella di istanza.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY	Non è possibile accedere a un registro di istanze.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT	Configurazione di un'istanza danneggiata.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER	Il chiamante API non è proprietario dell'istanza di LocalDB.
LOCALDB_ERROR_INTERNAL_ERROR	Errore imprevisto. Per informazioni, vedere il registro eventi.

Remarks

Per un esempio di codice che usa l'API LocalDB, vedere Informazioni di riferimento su SQL Server Express LocalDB.

Related content

• Informazioni sull'intestazione e sulla versione di SQL Server Express LocalDB