Função LocalDBCreateInstance

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

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

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_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 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