Fonction LocalDBGetInstances

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

Fichier d'en-tête : sqlncli.h

Syntaxe

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128
typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];
typedef TLocalDBInstanceName* PTLocalDBInstanceName;

HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames,
           LPDWORD lpdwNumberOfInstances
);

Paramètres

• pInstanceNames
  [Sortie] Si cette fonction retourne, elle contient les noms des instances nommées et par défaut de LocalDB sur la station de travail de l'utilisateur.

• lpdwNumberOfInstances
  [Entrée/sortie] En entrée, contient le nombre d'emplacements de noms d'instances dans la mémoire tampon de pInstanceNames. Dans la sortie, contient le nombre d'instances de LocalDB sur la station de travail de l'utilisateur.

Valeurs retournées

• 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_INSUFFICIENT_BUFFER
  Le tampon d'entrée est trop court, et la troncation n'a pas été demandée.

• LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
  Le 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'instance 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.

Notes

Pour un exemple de code qui utilise l'API LocalDB, consultez Référence SQL Server Express LocalDB.

Voir aussi

Concepts

En-tête et informations de version SQL Server Express LocalDB