Función LocalDBCreateInstance

Crea una nueva instancia de SQL Server Express LocalDB.

Archivo de encabezado: sqlncli.h

Sintaxis

HRESULT LocalDBCreateInstance(  
           PCWSTR wszVersion,  
           PCWSTR pInstanceName,   
           DWORD dwFlags   
);  

Parámetros

wszVersion
[Entrada] La versión de LocalDB, por ejemplo, 11.0 o 11.0.1094.2.

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

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

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_INSTANCE_FOLDER_PATH_TOO_LONG
La ruta de acceso donde se debe almacenar la instancia es mayor que MAX_PATH.

LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
La instancia especificada ya existe, pero su versión es inferior a la solicitada.

LOCALDB_ERROR_UNKNOWN_VERSION
La versión especificada no está disponible.

LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
El nivel de revisión especificado no está instalado.

LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
No se puede crear una carpeta en %userprofile%.

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_SQL_SERVER_STARTUP_FAILED
Se inicia un proceso de SQL Server, pero no se pudo iniciar SQL Server.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Una configuración de instancia está dañada.

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

Observaciones

Si ya existe una instancia de LocalDB totalmente funcional con el nombre especificado y su versión es igual o superior a la solicitada, el resultado es S_OK.

En los casos en los que una instancia existente se daña, se producirá un error en las llamadas posteriores al LocalDBCreateInstance método de API. Las instancias dañadas deben corregirse manualmente o eliminarse explícitamente para poder usarlas de nuevo.

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