Compartilhar via


LocalDBDeleteInstance function

Applies to:SQL Server

Remove a instância especificada de LocalDB do SQL Server Express.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBDeleteInstance(
           PCWSTR pInstanceName ,
           DWORD dwFlags
);

Arguments

pInstanceName

[Entrada] O nome da instância de LocalDB a ser removida.

dwFlags

[Entrada] Reservado para uso futuro. Atualmente deve ser definido como 0.

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 de instância especificado é inválido.
LOCALDB_ERROR_UNKNOWN_INSTANCE A instância especificada não existe.
LOCALDB_ERROR_INSTANCE_BUSY A instância especificada está em execução.
LOCALDB_ERROR_WAIT_TIMEOUT Ocorreu um tempo limite ao tentar adquirir bloqueios de sincronização.
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 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_CANNOT_MODIFY_INSTANCE_REGISTRY Um registro de instância não pode ser modificado.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Uma configuração de instância está corrompida.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER O chamador da API não é o proprietário da instância do Banco de Dados Local.
LOCALDB_ERROR_INTERNAL_ERROR Erro inesperado. Consulte o log de eventos para obter detalhes.

Remarks

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