Función LocalDBStartInstance

Artigo
07/04/2024

Se aplica a: SQL Server

Inicia la instancia de SQL Server Express LocalDB especificada.

Archivo de encabezado: msoledbsql.h

Sintaxis

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

Parámetros

pInstanceName
[Input] Nombre de la instancia de LocalDB que se va a iniciar.

dwFlags
[Entrada] Reservado para uso futuro. En estos momentos, se debe establecer en 0.

wszSqlConnection
[Salida] Búfer donde se almacena la cadena de conexión para la instancia de LocalDB.

lpcchSqlConnection
[Entrada/Salida] En la entrada contiene el tamaño de búfer de wszSqlConnection en caracteres, incluidos los valores NULL finales. En la salida, si el tamaño de búfer proporcionado es demasiado pequeño, contiene el tamaño de búfer necesario en caracteres, lo cual incluye los valores NULL finales.

Devoluciones

S_OK
La función se ha realizado correctamente.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB no está instalado en el equipo.

LOCALDB_ERROR_INVALID_PARAMETER
Uno o más parámetros de entrada especificados no son válidos.

LOCALDB_ERROR_INVALID_INSTANCE_NAME
El nombre de instancia de especificado no es válido.

LOCALDB_ERROR_UNKNOWN_INSTANCE
La instancia no existe.

LOCALDB_ERROR_INSUFFICIENT_BUFFER
El búfer wszSqlConnection especificado es demasiado pequeño.

LOCALDB_ERROR_WAIT_TIMEOUT
Se ha agotado el tiempo de espera mientras se intentaba adquirir bloqueos de sincronización.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
La ruta de acceso donde la instancia debe almacenarse es mayor que MAX_PATH.

LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
No se puede recuperar una carpeta de perfil de usuario.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
No se puede tener acceso a una carpeta de la instancia.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
No se puede tener acceso a un registro de la instancia.

LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
No se puede modificar un registro de la instancia.

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
No se puede crear un proceso para SQL Server.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Se ha iniciado un proceso de SQL Server, pero se ha producido un error al iniciar SQL Server.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Una configuración de instancia estaba dañada.

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
No se puede crear una instancia automática. Vea el registro de eventos de aplicación de Windows para obtener los detalles del error.

LOCALDB_ERROR_INTERNAL_ERROR
Se ha producido un error inesperado. Vea el registro de eventos para obtener detalles.

Detalles

Ell argumento del búfer de conexión (wszSqlConnection) y el argumento del tamaño de búfer de conexión (lpcchSqlConnection) son opcionales. La tabla siguiente muestra las opciones de uso de estos argumentos y sus resultados.

Búfer	Tamaño de búfer	Análisis razonado	Action
NULL	NULL	El usuario quiere iniciar la instancia y no necesita un nombre de canalización.	Inicia una instancia (sin devolución de canalización y no se requiere la devolución de tamaño de búfer).
NULL	Realizar la presentación	El usuario solicita el tamaño de búfer de salida. (En la llamada siguiente el usuario probablemente solicitará un inicio real).	Devuelve el tamaño de búfer necesario (sin inicio y sin devolución de canalización). El resultado es S_OK.
Realizar la presentación	NULL	No está permitido; entrada no correcta.	El resultado devuelto es LOCALDB_ERROR_INVALID_PARAMETER.
Realizar la presentación	Realizar la presentación	El usuario desea iniciar la instancia y necesita el nombre de la canalización para conectarse una vez se haya iniciado.	Comprueba el tamaño de búfer, inicia la instancia y devuelve el nombre de la canalización en el búfer. El argumento de tamaño del búfer devuelve la longitud de la cadena "server=", no incluida la terminación de valores NULL.

Para obtener un ejemplo de código que utilice LocalDB API, vea SQL Server Express LocalDB Reference.

Consulte también

Información de encabezado y versión de SQL Server Express LocalDB

Compartir por