Partilhar via

LocalDBCreateInstance function

Applies to:SQL Server

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

Header file:msoledbsql.h

Syntax

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

Arguments

wszVersion

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

pInstanceName

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

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 da instância especificado é inválido.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG O caminho onde a instância deve ser armazenada é maior do 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 Não é possível criar uma pasta 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 Um registro de instância não pode ser acessado.
LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY Um registro de instância não pode ser modificado.
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED Um processo do SQL Server é 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.

Remarks

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

Nos casos em que uma instância existente fica corrompida, as chamadas subsequentes para o LocalDBCreateInstance método API falham. As instâncias corrompidas devem ser corrigidas manualmente ou explicitamente excluídas antes de poderem ser usadas novamente.

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

Related content

  • Last updated on