Partilhar via

LocalDBStartInstance function

Applies to:SQL Server

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

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

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

dwFlags

[Entrada] Reservado para uso futuro. Atualmente deve ser definido como 0.

wszSqlConnection

[Realização] O buffer para armazenar a cadeia de conexão para a instância LocalDB.

lpcchSqlConnection

[Input/Output] On input contains the size of the wszSqlConnection buffer in characters, including any trailing nulls. Na saída, se o tamanho do buffer fornecido for muito pequeno, contém o tamanho do buffer necessário em caracteres, incluindo quaisquer nulos à direita.

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_UNKNOWN_INSTANCE A instância não existe.
LOCALDB_ERROR_INSUFFICIENT_BUFFER The specified buffer wszSqlConnection is too small.
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 onde 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 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_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 do Windows para obter detalhes do erro.
LOCALDB_ERROR_INTERNAL_ERROR Ocorreu um erro inesperado. Consulte o log de eventos para obter detalhes.

Details

Both the connection buffer argument (wszSqlConnection) and the connection buffer size argument (lpcchSqlConnection) are optional. A tabela a seguir mostra opções para usar esses argumentos e seus resultados.

Buffer Buffer size Rationale Action
NULL NULL O usuário deseja iniciar a instância e não precisa de um nome de pipe. Inicia uma instância (sem retorno de pipe e sem retorno de tamanho de buffer necessário).
NULL Present O usuário solicita o tamanho do buffer de saída. (Na próxima chamada, o usuário provavelmente pedirá um início real.) Retorna um tamanho de buffer necessário (sem início e sem retorno de pipe). O resultado é S_OK.
Present NULL Não permitido; entrada incorreta. O resultado retornado é LOCALDB_ERROR_INVALID_PARAMETER.
Present Present O usuário deseja iniciar a instância e precisa que o nome do pipe se conecte 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 buffer size retorna o comprimento da cadeia de caracteres "server=", não incluindo nulls de terminação.

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