LocalDBShareInstance function

Applies to:SQL Server

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

Header file:msoledbsql.h

Syntax

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

Arguments

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. Derzeit sollte auf 0.

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_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.

Remarks

Ein Codebeispiel, das die LocalDB-API verwendet, finden Sie unter SQL Server Express LocalDB-Referenz.

Related content

• SQL Server Express LocalDB-Header und Versionsinformationen