LocalDBShareInstance-Funktion

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

Headerdatei: sqlncli.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.

Rückgabewerte

• 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-Verweis.

Siehe auch

Konzepte

SQL Server Express LocalDB-Header und Versionsinformationen