Compartir a través de

Función LocalDBStartInstance

Inicia la instancia de SQL Server Express LocalDB especificada.

Archivo de encabezado: sqlncli.h

Sintaxis

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

Parámetros

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

dwFlags
[Entrada] Reservado para uso futuro. Actualmente debe establecerse en 0.

wszSqlConnection
[Salida] Búfer para almacenar la cadena de conexión en la instancia de LocalDB.

lpcchSqlConnection
[Entrada/salida] La entrada contiene el tamaño del búfer de wszSqlConnection en caracteres, incluidos los valores NULL finales. En la salida, si el tamaño del búfer especificado es demasiado pequeño, contiene el tamaño de búfer necesario en caracteres, incluidos 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 varios parámetros de entrada especificados no son válidos.

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

LOCALDB_ERROR_UNKNOWN_INSTANCE
La instancia no existe.

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

LOCALDB_ERROR_WAIT_TIMEOUT
Se agota el tiempo de espera al intentar adquirir los bloqueos de sincronización.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
La ruta de acceso donde se debe almacenar la instancia 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 instancia.

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

LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
No se puede modificar un registro de instancia.

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
No se puede crear un proceso para SQL Server.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Se inició un proceso de SQL Server, pero se produjo un error en el inicio de SQL Server.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Se ha dañado una configuración de instancia.

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
No se puede crear una instancia automática. Consulte el registro de eventos de la aplicación de Windows para obtener más información sobre los errores.

LOCALDB_ERROR_INTERNAL_ERROR
Error inesperado. Consulte el registro de eventos para obtener más información.

Detalles

Tanto el argumento de búfer de conexión (wszSqlConnection) como el argumento de tamaño del búfer de conexión (lpcchSqlConnection) son opcionales. En la tabla siguiente se muestran las opciones para usar estos argumentos y sus resultados.

Memoria intermedia Tamaño del búfer Análisis razonado Acción
NULO NULO El usuario quiere iniciar la instancia y no necesita un nombre de canalización. Inicia una instancia (sin devolución de canalización y sin devolución de tamaño de búfer necesaria).
NULO Presente El usuario solicita el tamaño del búfer de salida. (En la siguiente llamada, el usuario probablemente solicitará un inicio real). Devuelve un tamaño de búfer necesario (sin inicio y sin devolución de canalización). El resultado es S_OK.
Presente NULO No permitido; entrada incorrecta. El resultado devuelto es LOCALDB_ERROR_INVALID_PARAMETER.
Presente Presente El usuario quiere iniciar la instancia y necesita el nombre de canalización para conectarse a ella después de iniciarla. Comprueba el tamaño del búfer, inicia la instancia y devuelve el nombre de 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 usa la API de LocalDB, consulte Referencia de SQL Server Express LocalDB.

Véase también

Información de versiones y encabezados de SQL Server Express LocalDB

  • Last updated on