Fonction LocalDBCreateInstance

Crée une instance SQL Server Express LocalDB.

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

Syntaxe

HRESULT LocalDBCreateInstance(
           PCWSTR wszVersion,
           PCWSTR pInstanceName, 
           DWORD dwFlags 
);

Paramètres

• wszVersion
  [Entrée] Version de LocalDB, par exemple 11.0 ou 11.0.1094.2.

• pInstanceName
  [Entrée] Nom de l'instance de LocalDB à créer.

• dwFlags
  [Entrée] Réservé à un usage ultérieur. Actuellement doit avoir la valeur 0.

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_INVALID_INSTANCE_NAME
  Le nom d'instance spécifié n'est pas valide.

• 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_INSTANCE_EXISTS_WITH_LOWER_VERSION
  L'instance spécifiée existe déjà mais sa version est inférieure à celle demandée.

• LOCALDB_ERROR_UNKNOWN_VERSION
  La version spécifiée n'est pas disponible.

• LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
  Le niveau de correctif de logiciel spécifié n'est pas installé.

• LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
  Impossible de créer un dossier sous %userprofile%.

• LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
  Impossible de récupérer un dossier du profil utilisateur.

• LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
  Un dossier d'instance n'est pas accessible.

• LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
  Un Registre d'instance n'est pas accessible.

• LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
  Impossible de modifier un Registre d'instance.

• LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
  Un processus SQL Server est démarré, mais le démarrage de SQL Server a échoué.

• 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

Si une instance de LocalDB entièrement fonctionnelle portant le nom spécifié existe déjà et sa version est supérieure ou égale à la version demandée, le résultat est S_OK.

Dans les cas où une instance existante est endommagée, les appels suivants à la méthode d'API LocalDBCreateInstance échouent. Les instances endommagées doivent être corrigées manuellement ou être explicitement supprimées avant de pouvoir être réutilisées.

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