Funzione LocalDBStartInstance

Avvia l'istanza di SQL Server Express LocalDB specificata.

File di intestazione: sqlncli.h

Sintassi

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

Parametri

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

dwFlags
[Input] Riservato per uso futuro. Attualmente deve essere impostato su 0.

wszSqlConnection
[Output] Buffer in cui archiviare la stringa di connessione all'istanza di LocalDB.

lpcchSqlConnection
[Input/Output] Nell'input sono contenute le dimensioni del buffer wszSqlConnection in caratteri, inclusi eventuali valori Null finali. In caso di output, se la dimensione del buffer specificata è troppo piccola, contiene le dimensioni del buffer necessarie in caratteri, inclusi eventuali valori Null finali.

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

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

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_CANNOT_MODIFY_INSTANCE_REGISTRY
Non è possibile modificare un registro di istanze.

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
Non è possibile creare un processo per SQL Server.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
È stato avviato un processo di SQL Server, ma l'avvio di SQL Server non è riuscito.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Una configurazione dell'istanza è danneggiata.

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
Impossibile creare un'istanza automatica. Per informazioni dettagliate sull'errore, vedere il registro eventi dell'applicazione Windows.

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

Dettagli

Sia l'argomento buffer di connessione (wszSqlConnection) che l'argomento dimensioni del buffer di connessione (lpcchSqlConnection) sono facoltativi. La tabella seguente mostra le opzioni per l'uso di questi argomenti e i relativi risultati.

Memoria tampone	Dimensioni buffer	Motivazione	Azione
NULLO	NULLO	L'utente vuole avviare l'istanza e non ha bisogno di un nome pipe.	Avvia un'istanza (non viene restituita alcuna pipe e non viene restituita alcuna dimensione del buffer richiesta).
NULLO	Presente	L'utente chiede le dimensioni del buffer di output. Nella chiamata successiva l'utente richiederà probabilmente un inizio effettivo.	Restituisce una dimensione del buffer richiesta (nessun avvio e nessun ritorno della pipe). Il risultato è S_OK.
Presente	NULLO	Non consentito; input errato.	Il risultato restituito è LOCALDB_ERROR_INVALID_PARAMETER.
Presente	Presente	L'utente vuole avviare l'istanza e deve avere il nome della pipe per connettersi a esso dopo l'avvio.	Controlla le dimensioni del buffer, avvia l'istanza e restituisce 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.

Vedere anche

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