Delen via

LocalDBCreateInstance function

Applies to:SQL Server

Hiermee maakt u een nieuw EXEMPLAAR van SQL Server Express LocalDB.

Header file:msoledbsql.h

Syntax

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

Arguments

wszVersion

[Invoer] De LocalDB-versie, bijvoorbeeld 11.0 of 11.0.1094.2.

pInstanceName

[Invoer] De naam voor het LocalDB-exemplaar dat moet worden gemaakt.

dwFlags

[Invoer] Gereserveerd voor toekomstig gebruik. Momenteel moet worden ingesteld op 0.

Returns

S_OK: De functie is geslaagd.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB is niet geïnstalleerd op de computer.
LOCALDB_ERROR_INVALID_PARAMETER Een of meer opgegeven invoerparameters zijn ongeldig.
LOCALDB_ERROR_INVALID_INSTANCE_NAME De opgegeven exemplaarnaam is ongeldig.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Het pad waarin het exemplaar moet worden opgeslagen, is langer dan MAX_PATH.
LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION Het opgegeven exemplaar bestaat al, maar de versie is lager dan aangevraagd.
LOCALDB_ERROR_UNKNOWN_VERSION De opgegeven versie is niet beschikbaar.
LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED Het opgegeven patchniveau is niet geïnstalleerd.
LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER Er kan geen map worden gemaakt onder %userprofile%.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER Een gebruikersprofielmap kan niet worden opgehaald.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER Er kan geen exemplaarmap worden geopend.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Er kan geen exemplaarregister worden geopend.
LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY Een exemplaarregister kan niet worden gewijzigd.
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED Er wordt een SQL Server-proces gestart, maar het opstarten van SQL Server is mislukt.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Een exemplaarconfiguratie is beschadigd.
LOCALDB_ERROR_INTERNAL_ERROR Er is een onverwachte fout opgetreden. Zie het gebeurtenislogboek voor meer informatie.

Remarks

Als er al een volledig functioneel LocalDB-exemplaar met de opgegeven naam bestaat en de versie gelijk is aan of hoger is dan aangevraagd, is S_OKhet resultaat.

In gevallen waarin een bestaand exemplaar beschadigd raakt, mislukken volgende aanroepen naar de LocalDBCreateInstance API-methode. Beschadigde exemplaren moeten handmatig of expliciet worden verwijderd voordat ze opnieuw kunnen worden gebruikt.

Zie sql Server Express LocalDB-referentie voor een codevoorbeeld dat gebruikmaakt van de LocalDB-API van LocalDB.

Related content