Fonction LocalDBStartInstance

Démarre l'instance SQL Server Express LocalDB spécifiée.

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

Syntaxe

HRESULT LocalDBStartInstance(
           PCWSTR pInstanceName,
           DWORD dwFlags, 
           LPWSTR wszSqlConnection, 
           LPDWORD lpcchSqlConnection 
);

Paramètres

• pInstanceName
  [Entrée] Nom de l'instance de LocalDB à démarrer.

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

• wszSqlConnection
  [Sortie] Mémoire tampon pour stocker la chaîne de connexion à l'instance de LocalDB.

• lpcchSqlConnection
  [Entrée/sortie] En entrée contient la taille de la mémoire tampon de wszSqlConnection en caractères, y compris les zéros de fin. En sortie, si la taille de la mémoire tampon donnée est trop petite, contient la taille de la mémoire tampon requise en caractères, y compris les zéros de fin.

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_UNKNOWN_INSTANCE
  L'instance n'existe pas.

• LOCALDB_ERROR_INSUFFICIENT_BUFFER
  Le tampon de wszSqlConnection spécifié est trop petit.

• LOCALDB_ERROR_WAIT_TIMEOUT
  Un dépassement de délai s'est produit lors de la tentative d'acquisition des verrous de synchronisation.

• 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_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_CANNOT_CREATE_SQL_PROCESS
  Impossible de créer un processus pour SQL Server.

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

• LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
  Une configuration d'instance a été endommagée.

• LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
  Impossible de créer une instance automatique. Pour plus d'informations sur l'erreur, consultez le journal des événements des applications Windows.

• LOCALDB_ERROR_INTERNAL_ERROR
  Une erreur inattendue s'est produite. Pour plus d'informations, consultez le journal des événements.

Détails

L'argument de mémoire tampon de connexion (wszSqlConnection) et l'argument de taille de mémoire tampon de connexion (lpcchSqlConnection) sont facultatifs. Le tableau suivant affiche les options d'utilisation de ces arguments et leurs résultats.

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