PSYMBOL_REGISTERED_CALLBACK コールバック関数 (dbghelp.h)

SymRegisterCallback64 関数で使用されるアプリケーション定義のコールバック関数。 これはシンボル ハンドラーによって呼び出されます。

PSYMBOL_REGISTERED_CALLBACK64型は、このコールバック関数へのポインターを定義します。 SymRegisterCallbackProc64 は、アプリケーション定義関数名のプレースホルダーです。

構文

PSYMBOL_REGISTERED_CALLBACK PsymbolRegisteredCallback;

BOOL PsymbolRegisteredCallback(
  [in]           HANDLE hProcess,
  [in]           ULONG ActionCode,
  [in, optional] PVOID CallbackData,
  [in, optional] PVOID UserContext
)
{...}

パラメーター

[in] hProcess

SymInitialize 関数に最初に渡されたプロセスへのハンドル。

[in] ActionCode

コールバック コード。 このパラメーターには、次の値のいずれかを指定できます。

[in, optional] CallbackData

操作のデータ。 このデータの形式は 、ActionCode パラメーターの値によって異なります。

コールバック関数が SymRegisterCallbackW64 に登録されている場合、データは Unicode 文字列またはデータ構造です。 それ以外の場合、データは ANSI 形式を使用します。

[in, optional] UserContext

SymRegisterCallback64 または NULL で指定されたユーザー定義値。 通常、このパラメーターは、コールバック関数がコンテキストを確立できるようにするデータ構造へのポインターを渡すためにアプリケーションによって使用されます。

戻り値

コードの処理が成功したことを示すには、 TRUE を返します。

コードの処理に失敗したことを示すには、 FALSE を返します。 コードが特定のコードを処理しない場合は、 FALSE も返す必要があります。 (この場合 に TRUE を 返した場合、意図しない結果が生じる可能性があります)。

注釈

呼び出し元のアプリケーションは、シンボル ハンドラー関数の 1 つに対する別の呼び出しの結果として、登録済みのコールバック関数を介して呼び出されます。 呼び出し元のアプリケーションは、これが引き起こす可能性のある副作用に備える必要があります。 アプリケーションに複数のスレッドで使用されているコールバック関数が 1 つだけある場合は、コールバック関数のコンテキストで一部の種類のデータ アクセスを同期するために注意が必要な場合があります。

このコールバック関数は、 PSYMBOL_REGISTERED_CALLBACK コールバック関数よりも優先されます。 PSYMBOL_REGISTERED_CALLBACK は、Dbghelp.h で次のように定義されます。

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYMBOL_REGISTERED_CALLBACK PSYMBOL_REGISTERED_CALLBACK64
#else
typedef BOOL
(CALLBACK *PSYMBOL_REGISTERED_CALLBACK)(
    __in HANDLE hProcess,
    __in ULONG ActionCode,
    __in_opt PVOID CallbackData,
    __in_opt PVOID UserContext
    );
#endif

より広範な例については、「 通知の取得」を参照してください。

要件

こちらもご覧ください

DbgHelp 関数

通知の取得

IMAGEHLP_CBA_EVENT

IMAGEHLP_CBA_READ_MEMORY

IMAGEHLP_DEFERRED_SYMBOL_LOAD64

IMAGEHLP_DUPLICATE_SYMBOL64

SymRegisterCallback64