LocalDBShareInstance-Funktion

Artikel
01/02/2025

Gilt für: SQL Server

Gibt die angegebene SQL Server Express-LocalDB-Instanz für andere Benutzer des Computers frei und verwendet den angegebenen Freigabenamen.

Headerdatei: msoledbsql.h

Syntax

HRESULT LocalDBShareInstance(  
           PSID pOwnerSID,  
           PCWSTR pInstancePrivateName,  
           PCWSTR pInstanceSharedName,   
           DWORD dwFlags   
);

Parameter

pOwnerSID
[Eingabe] Die SID des Instanzeigentümers.

pInstancePrivateName
[Eingabe] Der private Name für die freizugebende LocalDB-Instanz.

pInstanceSharedName
[Eingabe] Der Freigabename für die freizugebende LocalDB-Instanz.

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_ADMIN_RIGHTS_REQUIRED
Administratorberechtigungen sind erforderlich, um diesen Vorgang auszuführen.

LOCALDB_ERROR_SHARED_NAME_TAKEN
Der angegebene freigegebene Name wird bereits verwendet.

LOCALDB_ERROR_INSTANCE_ALREADY_SHARED
Die angegebene Instanz ist bereits freigegeben.

LOCALDB_ERROR_INTERNAL_ERROR
Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie im Ereignisprotokoll.

Hinweise

Ein Codebeispiel, in dem die LocalDB-API verwendet wird, finden Sie unter SQL Server Express LocalDB Reference.

Weitere Informationen

SQL Server Express LocalDB-Header und -Versionsinformationen

Freigeben über