Not
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Applies to:
SQL Server
Skapar en ny SQL Server Express LocalDB-instans.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion ,
PCWSTR pInstanceName ,
DWORD dwFlags
);
Arguments
wszVersion
[Indata] LocalDB-versionen, till exempel 11.0 eller 11.0.1094.2.
pInstanceName
[Indata] Namnet på den LocalDB-instans som ska skapas.
dwFlags
[Indata] Reserverad för framtida användning. För närvarande bör anges till 0.
Returns
S_OK: Funktionen lyckades.
| Error | Description |
|---|---|
| LOCALDB_ERROR_NOT_INSTALLED | SQL Server Express LocalDB är inte installerat på datorn. |
| LOCALDB_ERROR_INVALID_PARAMETER | En eller flera angivna indataparametrar är ogiltiga. |
| LOCALDB_ERROR_INVALID_INSTANCE_NAME | Det angivna instansnamnet är ogiltigt. |
| LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG | Sökvägen där instansen ska lagras är längre än MAX_PATH. |
| LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION | Den angivna instansen finns redan men dess version är lägre än vad som begärts. |
| LOCALDB_ERROR_UNKNOWN_VERSION | Den angivna versionen är inte tillgänglig. |
| LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED | Den angivna korrigeringsnivån är inte installerad. |
| LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER | Det går inte att skapa en mapp under %userprofile%. |
| LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER | Det går inte att hämta en användarprofilmapp. |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER | Det går inte att komma åt en instansmapp. |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY | Det går inte att komma åt ett instansregister. |
| LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY | Det går inte att ändra ett instansregister. |
| LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED | En SQL Server-process startas men SQL Server-starten misslyckades. |
| LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT | En instanskonfiguration är skadad. |
| LOCALDB_ERROR_INTERNAL_ERROR | Ett oväntat fel uppstod. Mer information finns i händelseloggen. |
Remarks
Om det redan finns en fullt fungerande LocalDB-instans med det angivna namnet och dess version är lika med eller högre än vad som begärts blir S_OKresultatet .
I de fall då en befintlig instans blir skadad misslyckas efterföljande anrop till LocalDBCreateInstance API-metoden. Skadade instanser måste åtgärdas manuellt eller uttryckligen tas bort innan de kan användas igen.
Ett kodexempel som använder LocalDB API finns i SQL Server Express LocalDB-referens.