Funzione LocalDBStopInstance

Arresta l'esecuzione dell'istanza di SQL Server Express LocalDB specificata.

File di intestazione: sqlncli.h

Sintassi

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

Parametri

pInstanceName
[Input] Nome dell'istanza di LocalDB da arrestare.

dwFlags
[Input] Una o una combinazione dei valori del flag che specificano il modo per arrestare l'istanza.

Flag disponibili:

LOCALDB_SHUTDOWN_KILL_PROCESS
Arrestare immediatamente usando il comando del sistema operativo kill process.

LOCALDB_SHUTDOWN_WITH_NOWAIT
Arrestarsi usando l'opzione WITH NOWAIT Transact-SQL comando .

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

ulTimeout
[Input] Tempo in secondi di attesa del completamento dell'operazione. Se questo valore è 0, questa funzione verrà restituita immediatamente senza attendere l'arresto dell'istanza di LocalDB.

Restituzioni

S_OK
Funzione completata.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB non è installato nel computer.

LOCALDB_ERROR_INVALID_PARAMETER
Uno o più parametri di input specificati non sono validi.

LOCALDB_ERROR_INVALID_INSTANCE_NAME
Il nome dell'istanza specificato non è valido.

LOCALDB_ERROR_UNKNOWN_INSTANCE
L'istanza non esiste.

LOCALDB_ERROR_WAIT_TIMEOUT
Si è verificato un timeout durante il tentativo di acquisire i blocchi di sincronizzazione.

LOCALDB_ERROR_INSTANCE_STOP_FAILED
Impossibile completare l'operazione di arresto entro il tempo specificato.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
Il percorso in cui deve essere archiviata 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
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
Una configurazione dell'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 dettagliate, vedere il registro eventi.

Osservazioni:

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

Vedere anche

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