Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.