Partager via

fonction de rappel JET_PFNSTATUS

  • Article

S’applique à : Windows | Windows Server

fonction de rappel JET_PFNSTATUS

La fonction de rappel JET_PFNSTATUS reçoit des informations sur la progression des opérations de longue durée, telles que les opérations de défragmentation, de sauvegarde ou de restauration. Pendant ces opérations, le moteur de base de données appelle cette fonction de rappel pour fournir une mise à jour sur la progression de l’opération.

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

Paramètres

sesid

Session de type JET_SESID avec laquelle la fonction de longue durée a été appelée.

Snp

Type d’opération tel que spécifié dans JET_SNP. Les types d’opérations incluent la réparation, le compactage, la restauration, la sauvegarde, la mise à jour, le nettoyage et la mise à jour du format d’enregistrement.

Snt

Status d’une opération. Les types d’état incluent le début, le cours en cours, l’achèvement ou l’échec. Le status est spécifié avec le troisième paramètre de type JET_SNT.

pv

Pointeur facultatif vers une structure de type JET_SNPROG.

Valeur renvoyée

Cette fonction retourne le type de données JET_ERR avec l’un des codes d’erreur Du moteur de stockage extensible. Pour plus d’informations sur les erreurs ESE possibles, consultez Erreurs du moteur de stockage extensible et Paramètres de gestion des erreurs.

En cas de réussite, l’opération qui a émis le rappel peut se poursuivre normalement. Dans certains cas, le rappel peut renvoyer un avertissement qui influence cette opération.

En cas d’échec, l’opération qui a émis le rappel peut se poursuivre normalement ou échouer.

Notes

Cette fonction de rappel sera utilisée dans une notification de progression dans laquelle la structure indiquera l’état actuel de la progression. Notez que la fonction de rappel peut être appelée plusieurs fois pour la progression de l’opération.

Spécifications

Condition requise Valeur

Client

Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.

Serveur

Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.

En-tête

Déclaré dans Esent.h.

Voir aussi

Codes d’erreur du moteur de stockage extensible
Erreurs du moteur de stockage extensible
JET_SESID
JET_SNP
JET_SNPROG
JET_SNT