LocalDBShareInstance-Funktion

Teilt die angegebene SQL Server Express LocalDB-Instanz mit anderen Benutzern des Computers unter Verwendung des angegebenen freigegebenen Namens.

Headerdatei: sqlncli.h

Syntax

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

Die Parameter

pOwnerSID
[Eingabe] Die SID des Instanzbesitzers.

pInstancePrivateName
[Eingabe] Der private Name für die lokaleDB-Instanz, die freigegeben werden soll.

pInstanceSharedName
[Eingabe] Der freigegebene Name für die localDB-Instanz, die freigegeben werden soll.

dwFlags
[Eingabe] Reserviert für die zukünftige Verwendung. Derzeit sollte auf 0 festgelegt werden.

Rückkehr

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
Administratorrechte 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. Details finden Sie im Ereignisprotokoll.

Bemerkungen

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

Siehe auch

SQL Server Express LocalDB-Header und Versionsinformationen