Função LocalDBStartInstance

Inicia a instância do SQL Server Express LocalDB especificada.

Arquivo de cabeçalho: sqlncli.h

Sintaxe

HRESULT LocalDBStartInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           LPWSTR wszSqlConnection,   
           LPDWORD lpcchSqlConnection   
);  

Parâmetros

pInstanceName
[Entrada] O nome da instância do LocalDB a ser iniciada.

dwFlags
[Entrada] Reservado para uso futuro. No momento, deve ser definido como 0.

wszSqlConnection
[Saída] O buffer para armazenar a cadeia de conexão para a instância do LocalDB.

lpcchSqlConnection
[Entrada/Saída] Na entrada contém o tamanho do buffer wszSqlConnection em caracteres , incluindo todos os nulos à direita. Na saída, se o tamanho do buffer fornecido for muito pequeno, conterá o tamanho do buffer necessário em caracteres, incluindo todos os nulos à direita.

Devoluções

S_OK
A função foi bem-sucedida.

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_UNKNOWN_INSTANCE
A instância não existe.

LOCALDB_ERROR_INSUFFICIENT_BUFFER
O buffer especificado wszSqlConnection é muito pequeno.

LOCALDB_ERROR_WAIT_TIMEOUT
Ocorreu um tempo limite ao tentar adquirir os bloqueios de sincronização.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
O caminho em que a instância deve ser armazenada é maior que MAX_PATH.

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
Não é possível modificar um registro de instância.

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
Não é possível criar um processo para o SQL Server.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Um processo do SQL Server foi iniciado, mas a inicialização do SQL Server falhou.

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

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
Não é possível criar uma instância automática. Consulte o log de eventos do Aplicativo Windows para obter detalhes de erro.

LOCALDB_ERROR_INTERNAL_ERROR
Ocorreu um erro inesperado. Consulte o log de eventos para obter detalhes.

Detalhes

O argumento de buffer de conexão (wszSqlConnection) e o argumento de tamanho do buffer de conexão (lpcchSqlConnection) são opcionais. A tabela a seguir mostra opções para usar esses argumentos e seus resultados.

Buffer	Tamanho do buffer	Fundamento	Ação
NULO	NULO	O usuário deseja iniciar a instância e não precisa de um nome de pipe.	Inicia uma instância (nenhum retorno de pipe e nenhum retorno de tamanho de buffer necessário).
NULO	Presente	O usuário solicita o tamanho do buffer de saída. (Na próxima chamada, o usuário provavelmente solicitará um início real.)	Retorna um tamanho de buffer necessário (sem início e sem retorno de pipe). O resultado é S_OK.
Presente	NULO	Não permitido; entrada incorreta.	O resultado retornado é LOCALDB_ERROR_INVALID_PARAMETER.
Presente	Presente	O usuário deseja iniciar a instância e precisa do nome do pipe para se conectar a ela depois que ela for iniciada.	Verifica o tamanho do buffer, inicia a instância e retorna o nome do pipe no buffer. O argumento de tamanho de buffer retorna o comprimento da cadeia de caracteres "server=", não incluindo a terminação de nulos.

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

Consulte Também

Informações de cabeçalho e versão do SQL Server Express LocalDB