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] 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.

Devuelve

• 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 imprevisto. 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 Referencia de SQL Server Express LocalDB.

Vea también

Conceptos

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