Funzione LocalDBCreateInstance

Crea una nuova istanza di SQL Server Express LocalDB.

File di intestazione: sqlncli.h

Sintassi

HRESULT LocalDBCreateInstance(  
           PCWSTR wszVersion,  
           PCWSTR pInstanceName,   
           DWORD dwFlags   
);  

Parametri

wszVersion
[Input] Versione di LocalDB, ad esempio 11.0 o 11.0.1094.2.

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

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

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_INSTANCE_FOLDER_PATH_TOO_LONG
Il percorso in cui deve essere archiviata l'istanza è più lungo di MAX_PATH.

LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
L'istanza specificata esiste già, ma la relativa versione è inferiore a quella richiesta.

LOCALDB_ERROR_UNKNOWN_VERSION
La versione specificata non è disponibile.

LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
Il livello di patch specificato non è installato.

LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
Non è possibile creare una cartella in %userprofile%.

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_SQL_SERVER_STARTUP_FAILED
Viene 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_INTERNAL_ERROR
Errore imprevisto. Per informazioni dettagliate, vedere il registro eventi.

Osservazioni:

Se esiste già un'istanza localDB completamente funzionale con il nome specificato e la relativa versione è uguale o successiva a quella richiesta, il risultato viene S_OK.

Nei casi in cui un'istanza esistente viene danneggiata, le chiamate successive al LocalDBCreateInstance metodo API avranno esito negativo. Le istanze danneggiate devono essere corrette manualmente o eliminate in modo esplicito prima di poterle usare di nuovo.

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