Partager via


LocalDBShareInstance function

Applies to:SQL Server

Partage l'instance de base de données locale SQL Server Express spécifiée avec d'autres utilisateurs de l'ordinateur, en utilisant le nom partagé spécifié.

Header file:msoledbsql.h

Syntax

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

Arguments

pOwnerSID

[Entrée] SID du propriétaire de l'instance.

pInstancePrivateName

[Entrée] Nom privé de l'instance de base de données locale à partager.

pInstanceSharedName

[Entrée] Nom partagé de l'instance de base de données locale à partager.

dwFlags

[Entrée] Réservé à un usage ultérieur. Actuellement, la valeur doit être définie 0sur .

Returns

S_OK: la fonction a réussi.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB n’est pas installé sur l’ordinateur.
LOCALDB_ERROR_INVALID_PARAMETER Un ou plusieurs paramètres d'entrée spécifiés ne sont pas valides.
LOCALDB_ERROR_INVALID_INSTANCE_NAME Le nom d'instance spécifié n'est pas valide.
LOCALDB_ERROR_UNKNOWN_INSTANCE L’instance spécifiée n’existe pas.
LOCALDB_ERROR_ADMIN_RIGHTS_REQUIRED Des privilèges d'administrateur sont requis pour effectuer cette opération.
LOCALDB_ERROR_SHARED_NAME_TAKEN Le nom partagé spécifié est déjà utilisé.
LOCALDB_ERROR_INSTANCE_ALREADY_SHARED L'instance spécifiée est déjà partagée.
LOCALDB_ERROR_INTERNAL_ERROR Une erreur inattendue s’est produite. Pour plus d'informations, consultez le journal des événements.

Remarks

Pour obtenir un exemple de code qui utilise l’API LocalDB, consultez la référence SQL Server Express LocalDB.