Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Applies to:
SQL Server
Interrompe a execução da instância especificada do SQL Server Express LocalDB.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName ,
DWORD dwFlags ,
ULONG ulTimeout
);
Arguments
pInstanceName
[Entrada] O nome da instância LocalDB a ser interrompida.
dwFlags
[Entrada] Um ou uma combinação dos valores de sinalizador especificando a maneira de parar a instância.
Available flags:
LOCALDB_SHUTDOWN_KILL_PROCESS
Desligue imediatamente usando o comando terminate process operating system.
LOCALDB_SHUTDOWN_WITH_NOWAIT
Desligue usando o WITH NOWAIT comando option Transact-SQL.
Se nenhum dos sinalizadores estiver definido, a instância LocalDB será encerrada usando o SHUTDOWN comando Transact-SQL. Se ambas as bandeiras estiverem definidas, a LOCALDB_SHUTDOWN_KILL_PROCESS bandeira tem precedência.
ulTimeout
[Entrada] O tempo, em segundos, para aguardar a conclusão desta operação. Se esse valor for 0, essa função retornará imediatamente sem esperar que a instância LocalDB pare.
Returns
S_OK: A função foi bem-sucedida.
| Error | Description |
|---|---|
| LOCALDB_ERROR_NOT_INSTALLED | O SQL Server Express LocalDB não está instalado no computador. |
| LOCALDB_ERROR_INVALID_PARAMETER | Um ou mais parâmetros de entrada especificados são inválidos. |
| LOCALDB_ERROR_INVALID_INSTANCE_NAME | O nome da instância especificado é inválido. |
| LOCALDB_ERROR_UNKNOWN_INSTANCE | A instância não existe. |
| LOCALDB_ERROR_WAIT_TIMEOUT | Ocorreu um tempo limite ao tentar adquirir os bloqueios de sincronização. |
| LOCALDB_ERROR_INSTANCE_STOP_FAILED | A operação stop não foi concluída dentro do tempo dado. |
| LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG | O caminho onde a instância deve ser armazenada é maior que MAX_PATH. |
| LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER | Uma pasta de perfil de usuário não pode ser recuperada. |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER | Uma pasta de instância não pode ser acessada. |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY | Um registro de instância não pode ser acessado. |
| LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT | Uma configuração de instância está corrompida. |
| LOCALDB_ERROR_CALLER_IS_NOT_OWNER | O chamador de API não é proprietário de instância do LocalDB. |
| LOCALDB_ERROR_INTERNAL_ERROR | Ocorreu um erro inesperado. Consulte o log de eventos para obter detalhes. |
Remarks
Para obter um exemplo de código que usa a API LocalDB, consulte Referência do SQL Server Express LocalDB.