Función JetSetSessionParameter

Se aplica a: Windows | Windows Server

La función JetSetSessionParameter configura el motor de base de datos.

JET_ERR JET_API JetSetSessionParameter (
  __in_opt      JET_SESID sesid,
  __in          unsigned long sesparamid,
  __in_read_bytes_opt_(cbParam)  void* pvParam,
  __in          unsigned long cbParam
);

Parámetros

sesid

Especifica la sesión que se va a usar para esta llamada.

Cuando se especifica, se omite la instancia especificada y se usará la instancia asociada a la sesión.

sesparamid

Identificador del parámetro de sesión que se va a establecer.

pvParam

Datos que se van a establecer en este parámetro de sesión.

cbParam

Tamaño de los datos proporcionados.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los códigos de retorno enumerados en la tabla siguiente. Para obtener más información sobre los posibles errores del motor de almacenamiento extensible (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_errAlreadyInitialized	La instancia se ha inicializado mediante una llamada a la función JetInit y esta operación no se puede realizar como resultado. Esto puede ocurrir cuando se intenta configurar un parámetro del sistema después de un cambio en el valor del parámetro ya no puede afectar al estado del motor de base de datos.
JET_errClientRequestToStopJetService	No es posible completar la operación porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a la función JetStopService .
JET_errIndexTuplesInvalidLimits	Los parámetros de índice de tupla especificados no eran válidos. Este error solo se devuelve cuando el parámetro JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax o JET_paramIndexTuplesToIndexMax se establece en un valor no válido. Para obtener información sobre estos parámetros, vea Parámetros de índice.
JET_errInitInProgress	No es posible completar la operación porque se inicializa la instancia asociada a la sesión.
JET_errInstanceUnavailable	No es posible completar la operación porque la instancia asociada a la sesión ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos.
JET_errInvalidParameter	Uno de los parámetros proporcionados contenía un valor inesperado o contenía un valor que no tenía sentido cuando se combinaba con el valor de otro parámetro. Esto puede ocurrir cuando se produce lo siguiente: El identificador de parámetro del sistema especificado no es válido o no es compatible. Se intentó establecer un parámetro del sistema con valores de cadena con una cadena cuya longitud estaba fuera del intervalo legal para el parámetro. Se intentó establecer un parámetro del sistema con valores de cadena con una ruta de acceso de archivo donde la longitud de su representación de ruta de acceso absoluta estaba fuera del intervalo legal para ese parámetro. Se intentó establecer un parámetro del sistema con valores enteros con un entero que estaba fuera del intervalo legal para el parámetro . Se intentó establecer JET_paramUnicodeIndexDefault con un puntero de JET_UNICODEINDEX nulo, un LCID no válido o un conjunto no admitido de marcas LCMapString . No se puede establecer el parámetro del sistema especificado porque es de solo lectura. Se intentó establecer un parámetro del sistema después de llamar a la función JetInit , el motor de base de datos está en modo de instancia única y no se especificó una sesión. El parámetro del sistema especificado solo es global y se intentó establecer un valor específico de instancia para ese parámetro del sistema. El parámetro del sistema especificado es solo por instancia y se intentó establecer el valor global para ese parámetro del sistema.
JET_errInvalidPath	La ruta de acceso del sistema de archivos especificada no era válida. JetSetSessionParameter solo puede devolver este error al establecer parámetros del sistema que representan rutas de acceso del sistema de archivos. Por ejemplo, el parámetro JET_paramSystemPath puede devolver este error. Para obtener información sobre este parámetro, vea Parámetros del registro de transacciones.
JET_errNotInitialized	No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errRestoreInProgress	No es posible completar la operación porque hay una operación de restauración en curso en la instancia asociada a la sesión.
JET_errTermInProgress	No es posible completar la operación porque se está cerrando la instancia asociada a la sesión.
JET_errInvalidSesid	El identificador de sesión no es válido o hace referencia a una sesión cerrada. Este error no se devuelve en todas las circunstancias. Los identificadores solo se validan con el mejor esfuerzo.
JET_errInvalidInstance	El identificador de instancia no es válido o hace referencia a una instancia que se ha cerrado. Este error no se devuelve en todas las circunstancias. Los identificadores solo se validan con el mejor esfuerzo.

Si se ejecuta correctamente, el parámetro del sistema se establecerá en el valor proporcionado.

En caso de error, el valor del parámetro del sistema permanecerá sin cambios.

Requisitos

Requisito	Value
Cliente	Requiere Windows 8.
Servidor	Requiere Windows Server 2012.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.

Consulte también

JET_API_PTR
JET_ERR
JET_INSTANCE
JET_SESID
JetCreateInstance
JetGetSystemParameter
JetInit
Parámetros del sistema