Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
Applies to:
SQL Server
Erstellt eine neue SQL Server Express LocalDB-Instanz.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion ,
PCWSTR pInstanceName ,
DWORD dwFlags
);
Arguments
wszVersion
[Eingabe] Die LocalDB-Version, z. B. 11.0 oder 11.0.1094.2.
pInstanceName
[Eingabe] Der Name für die zu erstellende LocalDB-Instanz.
dwFlags
[Eingabe] Zur künftigen Verwendung reserviert. Muss derzeit auf 0 festgelegt sein.
Returns
S_OK: Die Funktion war erfolgreich.
| Error | Description |
|---|---|
| LOCALDB_ERROR_NOT_INSTALLED | SQL Server Express LocalDB ist nicht auf dem Computer installiert. |
| LOCALDB_ERROR_INVALID_PARAMETER | Mindestens ein angegebener Eingabeparameter ist ungültig. |
| LOCALDB_ERROR_INVALID_INSTANCE_NAME | Der angegebene Instanzname ist ungültig. |
| LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG | Der Pfad, unter dem die Instanz gespeichert werden soll, ist länger als MAX_PATH. |
| LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION | Die angegebene Instanz ist bereits vorhanden, aber ihre Version ist niedriger als angefordert. |
| LOCALDB_ERROR_UNKNOWN_VERSION | Die angegebene Version ist nicht verfügbar. |
| LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED | Die angegebene Patchebene ist nicht installiert. |
| LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER | Unter " kann kein Ordner erstellt %userprofile%werden. |
| LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER | Ein Benutzerprofilordner kann nicht abgerufen werden. |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER | Auf einen Instanzordner kann nicht zugegriffen werden. |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY | Auf eine Instanzregistrierung kann nicht zugegriffen werden. |
| LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY | Eine Instanzregistrierung kann nicht geändert werden. |
| LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED | Ein SQL Server-Prozess wird gestartet, der SQL Server-Start ist jedoch fehlgeschlagen. |
| LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT | Eine Instanzkonfiguration ist beschädigt. |
| LOCALDB_ERROR_INTERNAL_ERROR | Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie im Ereignisprotokoll. |
Remarks
Wenn eine voll funktionsfähige LocalDB-Instanz mit dem angegebenen Namen bereits vorhanden ist und die Version gleich oder höher als angefordert ist, lautet S_OKdas Ergebnis .
In Fällen, in dem eine vorhandene Instanz beschädigt wird, schlagen nachfolgende Aufrufe der LocalDBCreateInstance API-Methode fehl. Beschädigte Instanzen müssen manuell korrigiert oder explizit gelöscht werden, bevor sie wieder verwendet werden können.
Ein Codebeispiel, das die LocalDB-API verwendet, finden Sie unter SQL Server Express LocalDB-Referenz.