Función JetEnableMultiInstance

Se aplica a: Windows | Windows Server

Función JetEnableMultiInstance

La función JetEnableMultiInstance configura el motor de base de datos para su uso con varias instancias en el mismo proceso. Hay disponible una matriz opcional de parámetros del sistema global para el primer llamador que permite el cambio al modo de varias instancias.

Windows XP: JetEnableMultiInstance se presenta en Windows XP.

    JET_ERR JET_API JetEnableMultiInstance(
      __in_opt      JET_SETSYSPARAM* psetsysparam,
      __in_opt      unsigned long csetsysparam,
      __out_opt     unsigned long* pcsetsucceed
    );

Parámetros

psetsysparam

Matriz de parámetros del sistema global que se van a establecer si y solo si el motor entra en modo de varias instancias como resultado de esta llamada. Si csetsysparam es cero, se omite psetsysparam .

csetsysparam

Recuento de elementos de la matriz de parámetros globales que se van a establecer si y solo si el motor entra en modo de varias instancias como resultado de esta llamada. Si csetsysparam es cero, se omite psetsysparam .

pcsetsucceed

Puntero al recuento de parámetros del sistema global configurados correctamente como resultado de esta llamada.

Valor devuelto

Esta función devuelve el JET_ERR tipo de datos con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errIndexTuplesInvalidLimits	No se permitieron los parámetros de índice de tupla especificados. JetEnableMultiInstance solo puede devolver este error al establecer JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax o JET_paramIndexTuplesToIndexMax en un valor no válido. Windows XP: Este valor devuelto se introduce en Windows XP.
JET_errInvalidPath	La ruta de acceso del sistema de archivos especificada no era válida. JetEnableMultiInstance solo puede devolver este error al establecer parámetros del sistema que representan rutas de acceso del sistema de archivos. Por ejemplo, JET_paramSystemPath puede devolver este error.
JET_errRunningInOneInstanceMode	Error en la operación porque no es válido cuando el motor de base de datos funciona en modo de instancia única (modo de compatibilidad de Windows 2000).
JET_errSystemParamsAlreadySet	Error en JetEnableMultiInstance porque el motor ya está en modo de varias instancias. Nota Esto ocurrirá incluso si no se especifica ningún parámetro del sistema.

Si esta función se ejecuta correctamente, el motor de base de datos se configurará para que se ejecute en modo de varias instancias. El motor también se configuró correctamente con la lista opcional de parámetros del sistema global.

Si se produce un error en esta función, el motor de base de datos permanecerá en el modo actual. Si pcsetsucceed es distinto de cero, ese número de parámetros del sistema permanecerá establecido.

Observaciones

Esta función solo se debe usar si la aplicación debe configurar un conjunto determinado de parámetros del sistema de forma atómica al configurar el motor de base de datos para su uso en un escenario multiusuario en el mismo proceso. Si hay otro método de sincronización disponible, es preferible llamar a JetCreateInstance y JetSetSystemParameter por separado.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista o Windows XP.
Servidor	Requiere Windows Server 2008 o Windows Server 2003.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetEnableMultiInstanceW (Unicode) y JetEnableMultiInstanceA (ANSI).

Consulte también

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter