Função LocalDBStopInstance

Aplica-se a: 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