Compartir a través de

Función LocalDBCreateInstance

  • Artículo

Se aplica a: SQL Server

Crea una nueva instancia de SQL Server Express LocalDB.

Archivo de encabezado: msoledbsql.h

Sintaxis

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

Parámetros

wszVersion
[Entrada] 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. En estos momentos, se debe establecer 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 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_INSTANCE_FOLDER_PATH_TOO_LONG
La ruta de acceso donde la instancia debe almacenarse es mayor que MAX_PATH.

LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
La instancia especificada ya existe pero la versión es anterior a la solicitada.

LOCALDB_ERROR_UNKNOWN_VERSION
La versión especificada no está disponible.

LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
El nivel especificado de la revisión 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 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_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 está dañada.

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

Comentarios

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

En los casos en los que se daña una instancia existente, las llamadas ulteriores al método de la API LocalDBCreateInstance producirán un error. Las instancias dañadas deben corregirse manualmente o eliminarse explícitamente antes de que se puedan volver a usar.

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