Função LocalDBStopInstance

Impede a execução da instância do SQL Server Express LocalDB especificada.

Arquivo de cabeçalho: sqlncli.h

Sintaxe

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

Parâmetros

pInstanceName
[Entrada] O nome da instância do LocalDB a ser interrompida.

dwFlags
[Entrada] Uma ou uma combinação dos valores de sinalizador especificando a maneira de parar a instância.

Sinalizadores disponíveis:

LOCALDB_SHUTDOWN_KILL_PROCESS
Desligue imediatamente usando o comando do sistema operacional kill process.

LOCALDB_SHUTDOWN_WITH_NOWAIT
Desligue usando a opção WITH NOWAIT Transact-SQL comando.

Se nenhum dos sinalizadores estiver definido, a instância do LocalDB será desligada usando o comando SHUTDOWN Transact-SQL. Se ambos os sinalizadores estiverem definidos, o sinalizador LOCALDB_SHUTDOWN_KILL_PROCESS terá 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 do LocalDB pare.

Devoluções

S_OK
A função foi bem-sucedida.

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 de parada não foi concluída dentro do tempo determinado.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
O caminho em que 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
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 é o proprietário da instância do LocalDB.

LOCALDB_ERROR_INTERNAL_ERROR
Ocorreu um erro inesperado. Consulte o log de eventos para obter detalhes.

Observações

Para obter um exemplo de código que usa a API localdb, consulte a Referência do SQL Server Express LocalDB.

Consulte Também

Informações de cabeçalho e versão do SQL Server Express LocalDB