Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Applies to:
SQL Server
Crée une instance SQL Server Express LocalDB.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion ,
PCWSTR pInstanceName ,
DWORD dwFlags
);
Arguments
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.
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_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 spécifié n’est pas installé. |
| LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER | Un dossier ne peut pas être créé sous %userprofile%. |
| LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER | Impossible de récupérer un dossier de 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’instances n’est pas accessible. |
| LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY | Impossible de modifier un registre d’instances. |
| 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. |
Remarks
Si une instance LocalDB entièrement fonctionnelle portant le nom spécifié existe déjà et que sa version est égale ou supérieure à celle 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 obtenir un exemple de code qui utilise l’API LocalDB, consultez la référence SQL Server Express LocalDB.