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