Función JetGetThreadStats
Se aplica a: Windows | Windows Server
Función JetGetThreadStats
La función JetGetThreadStats recupera información de rendimiento del motor de base de datos para el subproceso actual. Se pueden usar varias llamadas para recopilar estadísticas que reflejen la actividad del motor de base de datos en este subproceso entre esas llamadas.
Windows Vista:JetGetThreadStats se introduce en Windows Vista.
JET_ERR JET_API JetGetThreadStats(
__out void* pvResult,
__in unsigned long cbMax
);
Parámetros
pvResult
Búfer de salida que recibe los datos de estadísticas del subproceso. El búfer contiene una estructura de JET_THREADSTATS después de una llamada correcta.
cbMax
Tamaño máximo en bytes del búfer de salida.
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_errBufferTooSmall |
Error en la operación porque el búfer de salida proporcionado era demasiado pequeño para contener los datos solicitados. La función JetGetThreadStats devolverá este error cuando el búfer de salida sea demasiado pequeño para contener la versión más pequeña de la estructura de JET_THREADSTATS compatible con el motor de base de datos. |
Si se ejecuta correctamente, el búfer de salida contendrá una estructura de JET_THREADSTATS que contiene estadísticas del motor de base de datos para el subproceso actual.
Si se produce un error, el estado del búfer de salida no está definido.
Comentarios
La información proporcionada por dos llamadas consecutivas de esta API está pensada para usarse para calcular el gasto de cualquier otra operación del motor de base de datos en el subproceso actual. Por lo general, esto se hace tomando un antes y después de leer las estadísticas y restando el recuento posterior del recuento anterior para obtener el recuento neto de las operaciones realizadas.
Por ejemplo, una aplicación podría llamar a JetGetThreadStats una vez para obtener una lectura inicial de las estadísticas del subproceso actual. A continuación, podría llamar a la función JetMove con el parámetro cRow establecido en JET_MoveNext para pasar a la siguiente entrada de índice en un índice. A continuación, podría llamar a JetGetThreadStats de nuevo para obtener otra lectura de las estadísticas del subproceso. A continuación, podría restar el contador cPageReferenced de la segunda lectura de la primera. El resultado sería el número de páginas de base de datos a las que hace referencia el motor de base de datos para realizar la operación JetMove .
Las estadísticas de cada subproceso se acumulan durante la vigencia de ese subproceso. Las estadísticas se restablecen si el archivo DLL del motor de base de datos se descarga del proceso de host.
Es probable que la estructura de JET_THREADSTATS se expanda en el futuro para contener más estadísticas. Se agregarán nuevas estadísticas al final de la estructura y se pueden recuperar con un mayor tamaño del búfer de salida. La presencia de estadísticas adicionales se puede deducir mediante un valor cbStruct mayor.
Requisitos
| Requisito | Value |
|---|---|
Cliente |
Requiere Windows Vista. |
Servidor |
Requiere Windows Server 2008. |
Encabezado |
Declarado en Esent.h. |
Library |
Use ESENT.lib. |
Archivo DLL |
Requiere ESENT.dll. |