función de devolución de llamada de JET_PFNSTATUS

Se aplica a: Windows | Windows Server

función de devolución de llamada de JET_PFNSTATUS

La función de devolución de llamada JET_PFNSTATUS recibe información sobre el progreso de las operaciones de larga duración, como la desfragmentación, la copia de seguridad o las operaciones de restauración. Durante estas operaciones, el motor de base de datos llama a esta función de devolución de llamada para proporcionar una actualización sobre el progreso de la operación.

    JET_ERR JET_API JET_PFNSTATUS(
                           JET_SESID  sesid,
                           JET_SNP snp,
                           JET_SNT snt,
                           void* pv
    );

Parámetros

sesid

La sesión de tipo JET_SESID con la que se llamó a la función de ejecución prolongada.

Snp

Tipo de operación especificado en JET_SNP. Los tipos de operaciones incluyen reparación, compactación, restauración, copia de seguridad, actualización, limpieza y actualización del formato de registro.

Snt

Estado de una operación. Los tipos de estado incluyen inicio, en curso, finalización o error. El estado se especificará con el tercer parámetro de tipo JET_SNT.

pv

Puntero opcional a una estructura de tipo JET_SNPROG.

Valor devuelto

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

Si se ejecuta correctamente, la operación que emitió la devolución de llamada puede continuar normalmente. En algunos casos, la devolución de llamada podría devolver una advertencia que influye en esa operación.

Si se produce un error, la operación que emitió la devolución de llamada podría continuar normalmente o podría producir un error.

Comentarios

Esta función de devolución de llamada se usará en una notificación de progreso en la que la estructura indicará el estado actual del progreso. Tenga en cuenta que la función de devolución de llamada puede llamarse varias veces para el progreso de la operación.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.

Consulte también

Códigos de error extensibles del motor de almacenamiento
Errores del motor de almacenamiento extensible
JET_SESID
JET_SNP
JET_SNPROG
JET_SNT