LocalDBStopInstance Fonction

Empêche l’exécution de l’instance SQL Server Express LocalDB spécifiée.

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

Syntaxe

HRESULT LocalDBStopInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           ULONG ulTimeout   
);  

Paramètres

pInstanceName
[Entrée] Nom de l’instance LocalDB à arrêter.

dwFlags
[Entrée] Une ou une combinaison des valeurs d’indicateur spécifiant la façon d’arrêter l’instance.

Indicateurs disponibles :

LOCALDB_SHUTDOWN_KILL_PROCESS
Arrêtez immédiatement à l’aide de la commande de système d’exploitation kill process.

LOCALDB_SHUTDOWN_WITH_NOWAIT
Arrêtez à l’aide de l’option WITH NOWAIT Transact-SQL commande.

Si aucun des indicateurs n’est défini, l’instance LocalDB est arrêtée à l’aide de la commande SHUTDOWN Transact-SQL. Si les deux indicateurs sont définis, l’indicateur LOCALDB_SHUTDOWN_KILL_PROCESS est prioritaire.

ulTimeout
[Entrée] Temps en secondes d’attente de la fin de cette opération. Si cette valeur est 0, cette fonction retourne immédiatement sans attendre que l’instance LocalDB s’arrête.

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_WAIT_TIMEOUT
Un délai d’attente s’est produit lors de la tentative d’acquisition des verrous de synchronisation.

LOCALDB_ERROR_INSTANCE_STOP_FAILED
L’opération d’arrêt n’a pas pu se terminer dans le délai donné.

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_INSTANCE_CONFIGURATION_CORRUPT
Une configuration d’instance est endommagée.

LOCALDB_ERROR_CALLER_IS_NOT_OWNER
L’appelant d’API n’est pas propriétaire de l’instance LocalDB.

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

Remarques

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