Partilhar via

Função LocalDBCreateInstance

  • Artigo

Aplica-se a: SQL Server

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

Arquivo de cabeçalho: msoledbsql.h

Sintaxe

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

Parâmetros

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

pInstanceName
[Entrada] O nome para a instância de LocalDB ser criada.

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

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_INSTANCE_FOLDER_PATH_TOO_LONG
O caminho em que a instância deve estar armazenada não é 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 abaixo de %userprofile%.

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_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 houve falha na inicialização do SQL Server.

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

LOCALDB_ERROR_INTERNAL_ERROR
Erro inesperado. Consulte o log de eventos para obter detalhes.

Comentários

Se uma instância de LocalDB completamente funcional com o nome especificado já existir e sua versão for igual a ou mais alta que a solicitada, o resultado será S_OK.

Em casos em que uma instância existente torna-se corrompida, chamadas subsequentes para a API do método LocalDBCreateInstance falharão. As instâncias corrompidas devem ser corrigidas manualmente ou explicitamente excluídas antes de poderem ser usadas novamente.

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