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

Artigo
11/20/2024

Uma função de retorno de chamada definida pelo aplicativo usada com a função FindExecutableImageEx. Ele verifica se o arquivo executável encontrado por FindExecutableImageEx é o arquivo executável correto.

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

Sintaxe

PFIND_EXE_FILE_CALLBACKW PfindExeFileCallbackw;

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

Parâmetros

[in] FileHandle

Um identificador para o arquivo executável.

[in] FileName

O nome do arquivo executável.

[in] CallerData

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

Valor de retorno

Se o arquivo executável for válido, retorne VERDADEIRO. Caso contrário, retorne FALSE .

Observações

Nota

O cabeçalho dbghelp.h define PFIND_EXE_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

FindExecutableImageEx

Compartilhar via