Funzione LocalDBStartInstance

Articolo
07/04/2024

Si applica a: SQL Server

Avvia l'istanza specificata del database locale di SQL Server Express.

File di intestazione: msoledbsql.h

Sintassi

HRESULT LocalDBStartInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           LPWSTR wszSqlConnection,   
           LPDWORD lpcchSqlConnection   
);

Parametri

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

dwFlags
[Input] Riservato per utilizzi futuri. Deve essere impostato attualmente su 0.

wszSqlConnection
[Output] Buffer per archiviare la stringa di connessione nell'istanza del database locale.

lpcchSqlConnection
[Input/Output] Nell'input sono contenute le dimensioni del buffer wszSqlConnection in caratteri, inclusi eventuali valori Null finali. In fase di output, se le dimensioni del buffer specificate sono troppo piccole, nel parametro sono contenute le dimensioni del buffer richieste in caratteri, inclusi gli spazi vuoti finali.

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_INSUFFICIENT_BUFFER
Il buffer specificato wszSqlConnection è troppo piccolo.

LOCALDB_ERROR_WAIT_TIMEOUT
Timeout durante il tentativo di acquisizione dei blocchi di sincronizzazione.

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_CANNOT_MODIFY_INSTANCE_REGISTRY
Impossibile modificare il Registro di sistema di un'istanza.

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
Impossibile creare un processo per SQL Server.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Avviato processo di SQL Server ma tale operazione non è stata completata.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Configurazione di un'istanza danneggiata.

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
Impossibile creare un'istanza automatica. Per informazioni sugli errori, vedere il registro eventi applicazioni di Windows.

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

Dettagli

Sia l'argomento buffer di connessione (wszSqlConnection) che l'argomento dimensioni del buffer di connessione (lpcchSqlConnection) sono facoltativi. Nella tabella seguente vengono mostrate le opzioni per l'utilizzo di questi argomenti e dei relativi risultati.

Buffer	Dimensioni del buffer	Spiegazione	Azione
NULL	NULL	L'utente vuole avviare l'istanza e non ha bisogno di un nome pipe.	Viene avviata un'istanza. Non viene restituita alcuna pipe né le dimensioni del buffer richieste.
NULL	Present	L'utente richiede le dimensioni del buffer di output. Nella chiamata successiva probabilmente l'utente richiederà un avvio effettivo.	Vengono restituite le dimensioni del buffer richieste (nessun avvio né restituzione di pipe). Il risultato è S_OK.
Present	NULL	Non consentito. Input non corretto.	Il risultato restituito è LOCALDB_ERROR_INVALID_PARAMETER.
Present	Present	L'utente desidera avviare l'istanza e necessita del nome della pipe per la connessione a quest'ultima dopo il relativo avvio.	Vengono controllate le dimensioni del buffer, viene avviata l'istanza e viene restituito il nome della pipe nel buffer. L'argomento dimensioni buffer restituisce la lunghezza della stringa "server=", senza includere i valori Null di terminazione.

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