Funzione LocalDBCreateInstance

Articolo
07/04/2024

Si applica a: SQL Server

Viene creata un'istanza del database locale di SQL Server Express.

File di intestazione: msoledbsql.h

Sintassi

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

Parametri

wszVersion
[Input] Versione del database locale, ad esempio 11.0 o 11.0.1094.2.

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

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

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_INSTANCE_FOLDER_PATH_TOO_LONG
Percorso di archiviazione richiesto per l'istanza più lungo di MAX_PATH.

LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
Istanza specificata già esistente ma con relativa versione meno recente di quella richiesta.

LOCALDB_ERROR_UNKNOWN_VERSION
Versione specificata non disponibile.

LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
Livello di patch specificato non installato.

LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
Impossibile creare una cartella in %profiloutente%.

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

Osservazioni:

Se un'istanza del database locale completamente funzionale con il nome specificato già esiste e la versione è uguale o successiva rispetto a quella richiesta, il risultato è S_OK.

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

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