Partager via

LocalDBStartInstance, fonction

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 LocalDB à démarrer.

dwFlags
[Entrée] Réservé pour une utilisation ultérieure. Actuellement, la valeur 0 doit être définie.

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

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

Retours

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
La mémoire tampon spécifiée wszSqlConnection est trop petite.

LOCALDB_ERROR_WAIT_TIMEOUT
Un délai d’attente 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 de profil utilisateur.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
Impossible d’accéder à un dossier d’instance.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
Impossible d’accéder à un registre d’instances.

LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
Impossible de modifier un registre d’instances.

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 les erreurs, consultez le journal des événements de l’application 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 la mémoire tampon de connexion (lpcchSqlConnection) sont facultatifs. Le tableau suivant présente les options d’utilisation de ces arguments et de leurs résultats.

Tampon Taille de la mémoire tampon Justification Action
ZÉRO ZÉRO L’utilisateur souhaite démarrer l’instance et n’a pas besoin d’un nom de canal. Démarre une instance (aucun retour de canal et aucun retour de taille de mémoire tampon requis).
ZÉRO Présent L’utilisateur demande la taille de la mémoire tampon de sortie. (Dans l’appel suivant, l’utilisateur demandera probablement un démarrage réel.) Retourne une taille de mémoire tampon requise (aucun début et aucun retour de canal). Le résultat est S_OK.
Présent ZÉRO Non autorisé ; entrée incorrecte. Le résultat retourné est LOCALDB_ERROR_INVALID_PARAMETER.
Présent Présent L’utilisateur souhaite démarrer l’instance et a besoin du nom du canal pour se connecter après son démarrage. Vérifie la taille de la mémoire tampon, démarre l’instance et retourne le nom du canal dans la mémoire tampon.
L’argument de taille de mémoire tampon retourne la longueur de la chaîne « server= », sans inclure la fin des valeurs Null.

Pour obtenir un exemple de code qui utilise l’API LocalDB, consultez la référence SQL Server Express LocalDB.

Voir aussi

Informations sur l’en-tête et la version SQL Server Express LocalDB

  • Last updated on