Partager via


LocalDBGetInstances function

Applies to:SQL Server

Retourne toutes les instances de SQL Server Express LocalDB avec la version donnée.

Header file:msoledbsql.h

Syntax

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName [ MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1 ] ;
typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames ,
           LPDWORD lpdwNumberOfInstances
);

Arguments

pInstanceNames

[Sortie] Lorsque cette fonction est retournée, contient les noms des instances LocalDB nommées et par défaut sur la station de travail de l’utilisateur.

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. En sortie, cette option contient le nombre d’instances LocalDB trouvées sur la station de travail de l’utilisateur.

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_INSUFFICIENT_BUFFER La mémoire tampon d’entrée est trop courte et la troncation n’a pas été demandée.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Chemin d’accès où l’instance doit être stockée est plus long que MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Un registre d’instances n’est pas accessible.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Une configuration d'instance est endommagé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.