Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Applies to:
SQL Server
Cria uma nova instância de LocalDB do SQL Server Express.
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 para a instância de LocalDB 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 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 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 | Um registro de instância não pode ser modificado. |
| 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. |
Remarks
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 fica corrompida, as chamadas subsequentes para o método de LocalDBCreateInstance 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 a referência do SQL Server Express LocalDB.