LocalDBDeleteInstance-Funktion
Entfernt die angegebene SQL Server Express LocalDB-Instanz.
Headerdatei: sqlncli.h
Syntax
HRESULT LocalDBDeleteInstance(
PCWSTR pInstanceName,
DWORD dwFlags
);
Parameter
pInstanceName
[Eingabe] Der Name der LocalDB-Instanz, die entfernt werden soll.
dwFlags
[Eingabe] Zur künftigen Verwendung reserviert. Muss derzeit auf 0 festgelegt sein.
Gibt zurück
S_OK
Die Funktion wurde erfolgreich ausgeführt.
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_UNKNOWN_INSTANCE
Die angegebene Instanz ist nicht vorhanden.
LOCALDB_ERROR_INSTANCE_BUSY
Die angegebene Instanz wird ausgeführt.
LOCALDB_ERROR_WAIT_TIMEOUT
Beim versuchten Abrufen der Synchronisierungssperren ist ein Timeout aufgetreten.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
Der Pfad, unter dem die Instanz gespeichert werden soll, ist länger als MAX_PATH.
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 bearbeitet werden.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Eine Instanzkonfiguration ist beschädigt.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER
API-Aufrufer ist kein Eigentümer der lokalen Datenbankinstanz.
LOCALDB_ERROR_INTERNAL_ERROR
Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie im Ereignisprotokoll.
Bemerkungen
Ein Codebeispiel, in dem die LocalDB-API verwendet wird, finden Sie unter SQL Server Express LocalDB Reference.