Função LocalDBStopInstance
Aplica-se: SQL Server
Interrompe a execução da instância especificada de LocalDB do SQL Server Express.
Arquivo de cabeçalho: msoledbsql.h
Sintaxe
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
ULONG ulTimeout
);
Parâmetros
pInstanceName
[Entrada] O nome da instância de LocalDB a ser interrompida.
dwFlags
[Entrada] Uma ou uma combinação dos valores de sinalizador que especificam o modo de parar a instância.
Sinalizadores disponíveis:
LOCALDB_SHUTDOWN_KILL_PROCESS
Desligue imediatamente usando o comando do sistema operacional de eliminar processo.
LOCALDB_SHUTDOWN_WITH_NOWAIT
Desligue usando a opção WITH NOWAIT do comando Transact-SQL.
Se nenhum dos sinalizadores estiver definido, a instância de LocalDB será desligada usando o comando Transact-SQL SHUTDOWN. Se ambos os sinalizadores estiverem definidos, o sinalizador LOCALDB_SHUTDOWN_KILL_PROCESS terá precedência.
ulTimeout
[Entrada] O tempo em segundos que deve ser aguardado para essa operação ser concluída. Se este valor for 0, esta função retornará imediatamente sem aguardar que a instância LocalDB pare.
Devoluções
S_OK
A função foi bem-sucedida.
LOCALDB_ERROR_NOT_INSTALLED
O LocalDB do SQL Server Express 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 de instância especificado é inválido.
LOCALDB_ERROR_UNKNOWN_INSTANCE
A instância não existe.
LOCALDB_ERROR_WAIT_TIMEOUT
Tempo limite esgotado durante tentativa de obtenção de bloqueios de sincronização.
LOCALDB_ERROR_INSTANCE_STOP_FAILED
A operação de interrupção não foi concluída no tempo determinado.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
O caminho em que a instância deve estar armazenada não é maior que MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
Não é possível recuperar uma pasta de perfil de usuário.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
Não é possível acessar uma pasta de instância.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
Não é possível acessar um registro de instância.
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 da instância de LocalDB.
LOCALDB_ERROR_INTERNAL_ERROR
Erro inesperado. Consulte o log de eventos para obter detalhes.
Comentários
Para obter uma amostra do código que usa a API LocalDB, consulte SQL Server Express LocalDB Reference.
Confira também
Cabeçalho e informações de versão de LocalDB do SQL Server Express