Função LocalDBCreateInstance

Cria uma nova instância do SQL Server Express LocalDB.

Arquivo de cabeçalho: sqlncli.h

Sintaxe

HRESULT LocalDBCreateInstance(  
           PCWSTR wszVersion,  
           PCWSTR pInstanceName,   
           DWORD dwFlags   
);  

Parâmetros

wszVersion
[Entrada] A versão do LocalDB, por exemplo, 11.0 ou 11.0.1094.2.

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

dwFlags
[Entrada] Reservado para uso futuro. No momento, deve ser definido como 0.

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_INSTANCE_FOLDER_PATH_TOO_LONG
O caminho em que a instância deve ser armazenada é maior que MAX_PATH.

LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
A instância especificada já existe, mas sua versão é inferior à solicitada.

LOCALDB_ERROR_UNKNOWN_VERSION
A versão especificada não está disponível.

LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
O nível de patch especificado não está instalado.

LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
Uma pasta não pode ser criada em %userprofile%.

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
Não é possível modificar um registro de instância.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Um processo do SQL Server foi iniciado, mas a inicialização do SQL Server falhou.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Uma configuração de instância está corrompida.

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

Observações

Se uma instância localDB totalmente funcional com o nome especificado já existir e sua versão for igual ou superior à solicitada, o resultado será S_OK.

Nos casos em que uma instância existente estiver corrompida, as chamadas subsequentes ao método de LocalDBCreateInstance API falharão. Instâncias corrompidas devem ser corrigidas manualmente ou explicitamente excluídas antes que possam ser usadas novamente.

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