PFIND_DEBUG_FILE_CALLBACKW fonction de rappel (dbghelp.h)

Article
11/20/2024

Fonction de rappel définie par l’application utilisée avec la fonction FindDebugInfoFileEx. Il vérifie si le fichier de symboles situé par FindDebugInfoFileEx est le fichier de symboles correct.

Les types PFIND_DEBUG_FILE_CALLBACK et PFIND_DEBUG_FILE_CALLBACKW définissent un pointeur vers cette fonction de rappel. FindDebugInfoFileProc est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

PFIND_DEBUG_FILE_CALLBACKW PfindDebugFileCallbackw;

BOOL PfindDebugFileCallbackw(
  [in] HANDLE FileHandle,
  [in] PCWSTR FileName,
  [in] PVOID CallerData
)
{...}

Paramètres

[in] FileHandle

Handle du fichier de symboles.

[in] FileName

Nom du fichier de symboles.

[in] CallerData

Données facultatives définies par l’utilisateur. Ce paramètre peut être NULL.

Valeur de retour

Si le fichier de symboles est valide, retournez TRUE. Sinon, retournez FALSE.

Remarques

Une façon de vérifier que le fichier de symboles consiste à comparer son horodatage à l’horodatage dans l’image. Pour récupérer l’horodatage de l’image, utilisez la fonction GetTimestampForLoadedLibrary. Pour récupérer l’horodatage du fichier de symboles, utilisez la fonction SymGetModuleInfo64.

Note

L’en-tête dbghelp.h définit PFIND_DEBUG_FILE_CALLBACK en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.