LocalDBStartInstance function

Applies to:SQL Server

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

Header file:msoledbsql.h

Syntax

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

Arguments

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] On input contains the size of the wszSqlConnection buffer in characters, including any trailing nulls. 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.

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_INSUFFICIENT_BUFFER	The specified buffer wszSqlConnection is too small.
LOCALDB_ERROR_WAIT_TIMEOUT	Timeout durante il tentativo di acquisizione dei blocchi di sincronizzazione.
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_CANNOT_MODIFY_INSTANCE_REGISTRY	Non è possibile modificare un registro di istanza.
LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS	Non è possibile 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	Non è possibile 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.

Details

Both the connection buffer argument (wszSqlConnection) and the connection buffer size argument (lpcchSqlConnection) are optional. Nella tabella seguente vengono mostrate le opzioni per l'utilizzo di questi argomenti e dei relativi risultati.

Buffer	Buffer size	Rationale	Action
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 vuole avviare l'istanza e deve avere il nome della pipe per connettersi a esso dopo l'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.

Related content

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