Funzione LocalDBStopInstance

Articolo
08/21/2023

Si applica a: SQL Server

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

File di intestazione: msoledbsql.h

Sintassi

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

Parametri

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.

Flag disponibili:

LOCALDB_SHUTDOWN_KILL_PROCESS
Arrestare immediatamente l'utilizzo del comando del sistema operativo relativo al processo di terminazione.

LOCALDB_SHUTDOWN_WITH_NOWAIT
Arrestare l'utilizzo del comando Transact-SQL dell'opzione NOWAIT.

Se non è impostato nessuno dei flag, l'istanza del database verrà arrestata tramite il comando Transact-SQL SHUTDOWN. Se sono impostati entrambi i flag, ha la precedenza il flag LOCALDB_SHUTDOWN_KILL_PROCESS.

ulTimeout
[Input] Ora in secondi di attesa per il completamento di questa operazione. Se questo valore è 0, verrà restituito immediatamente un valore senza attendere l'arresto dell'istanza del database locale.

Valori restituiti

S_OK
Funzione completata.

LOCALDB_ERROR_NOT_INSTALLED
Database locale di SQL Server Express 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
Istanza inesistente.

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
Percorso di archiviazione richiesto per l'istanza più lungo di MAX_PATH.

LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
Impossibile recuperare una cartella del profilo utente.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
Impossibile accedere alla cartella di un'istanza.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
Impossibile accedere al Registro di sistema di un'istanza.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Configurazione di un'istanza danneggiata.

LOCALDB_ERROR_CALLER_IS_NOT_OWNER
Il chiamante API non è il proprietario dell'istanza del database locale.

LOCALDB_ERROR_INTERNAL_ERROR
Errore imprevisto. Per informazioni, vedere il registro eventi.

Osservazioni:

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

Vedi anche

Informazioni sulla versione e intestazione di SQL Server Express LocalDB

Condividi tramite