Função LocalDBStopInstance

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

Arquivo de cabeçalho: sqlncli.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.

Retorna

• 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 Referência de LocalDB do SQL Server Express.

Consulte também

Conceitos

Cabeçalho e informações de versão de LocalDB do SQL Server Express