Fonction LocalDBShareInstance

Article
11/24/2024

S'applique à : 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é.

Fichier d’en-tête : msoledbsql.h

Syntaxe

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

Paramètres

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 doit avoir la valeur 0.

Retours

S_OK
La fonction a réussi.

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.

Notes

Pour un exemple de code qui utilise l'API LocalDB, consultez SQL Server Express LocalDB Reference.

Voir aussi

En-tête et informations de version de la base de données locale SQL Server Express

Partager via