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
Arrête l'exécution de l'instance SQL Server Express LocalDB spécifiée.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName ,
DWORD dwFlags ,
ULONG ulTimeout
);
Arguments
pInstanceName
[Entrée] Nom de l'instance de LocalDB à arrêter.
dwFlags
[Entrée] Valeur d'indicateur ou combinaison de valeurs d'indicateur indiquant la façon d'arrêter l'instance.
Available flags:
LOCALDB_SHUTDOWN_KILL_PROCESS
Arrêtez immédiatement à l’aide de la commande de système d’exploitation de processus d’arrêt.
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 SHUTDOWN commande Transact-SQL. Si les deux indicateurs sont définis, l’indicateur LOCALDB_SHUTDOWN_KILL_PROCESS est prioritaire.
ulTimeout
[Entrée] Durée d'attente en secondes pour l'exécution de cette opération. Si cette valeur est 0, cette fonction retourne immédiatement sans attendre que l’instance LocalDB s’arrête.
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_UNKNOWN_INSTANCE | L’instance n’existe pas. |
| 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_STOP_FAILED | L'opération d'arrêt ne s'est pas terminée dans le délai imparti. |
| LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG | 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 | Un dossier d’instance n’est pas accessible. |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY | Un registre d’instances n’est pas accessible. |
| 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. |
Remarks
Pour obtenir un exemple de code qui utilise l’API LocalDB, consultez la référence SQL Server Express LocalDB.