Compartilhar via


PFIND_DEBUG_FILE_CALLBACKW função de retorno de chamada (dbghelp.h)

Uma função de retorno de chamada definida pelo aplicativo usada com a função FindDebugInfoFileEx. Ele verifica se o arquivo de símbolo localizado por FindDebugInfoFileEx é o arquivo de símbolo correto.

Os tipos PFIND_DEBUG_FILE_CALLBACK e PFIND_DEBUG_FILE_CALLBACKW definem um ponteiro para essa função de retorno de chamada. FindDebugInfoFileProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PFIND_DEBUG_FILE_CALLBACKW PfindDebugFileCallbackw;

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

Parâmetros

[in] FileHandle

Um identificador para o arquivo de símbolo.

[in] FileName

O nome do arquivo de símbolo.

[in] CallerData

Dados opcionais definidos pelo usuário. Esse parâmetro pode ser NULL.

Valor de retorno

Se o arquivo de símbolo for válido, retorne VERDADEIRO. Caso contrário, retorne FALSE .

Observações

Uma maneira de verificar o arquivo de símbolo é comparar seu carimbo de data/hora com o carimbo de data/hora na imagem. Para recuperar o carimbo de data/hora da imagem, use a função GetTimestampForLoadedLibrary. Para recuperar o carimbo de data/hora do arquivo de símbolo, use a função SymGetModuleInfo64.

Nota

O cabeçalho dbghelp.h define PFIND_DEBUG_FILE_CALLBACK como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
da Plataforma de Destino Windows
cabeçalho dbghelp.h
redistribuível DbgHelp.dll 5.1 ou posterior

Consulte também

do DbgHelp Functions

FindDebugInfoFileEx

GetTimestampForLoadedLibrary

SymGetModuleInfo64