PFIND_DEBUG_FILE_CALLBACKW Rückruffunktion (dbghelp.h)

Artikel
11/20/2024

Eine anwendungsdefinierte Rückruffunktion, die mit der funktion FindDebugInfoFileEx verwendet wird. Es überprüft, ob die Symboldatei, die sich von FindDebugInfoFileEx befindet, die richtige Symboldatei ist.

Die Typen PFIND_DEBUG_FILE_CALLBACK und PFIND_DEBUG_FILE_CALLBACKW definieren einen Zeiger auf diese Rückruffunktion. FindDebugInfoFileProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PFIND_DEBUG_FILE_CALLBACKW PfindDebugFileCallbackw;

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

Parameter

[in] FileHandle

Ein Handle für die Symboldatei.

[in] FileName

Der Name der Symboldatei.

[in] CallerData

Optionale benutzerdefinierte Daten. Dieser Parameter kann NULL-sein.

Rückgabewert

Wenn die Symboldatei gültig ist, geben Sie TRUEzurück. Andernfalls wird FALSE-zurückgegeben.

Bemerkungen

Eine Möglichkeit, die Symboldatei zu überprüfen, besteht darin, den Zeitstempel mit dem Zeitstempel im Bild zu vergleichen. Um den Zeitstempel des Bilds abzurufen, verwenden Sie die GetTimestampForLoadedLibrary-Funktion. Um den Zeitstempel der Symboldatei abzurufen, verwenden Sie die SymGetModuleInfo64--Funktion.

Anmerkung

Der dbghelp.h-Header definiert PFIND_DEBUG_FILE_CALLBACK als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.