次の方法で共有

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

  • [アーティクル]

SymEnumerateSymbols64 関数で使用されるアプリケーション定義のコールバック関数。 列挙されたシンボルごとに 1 回呼び出され、シンボル情報を受け取ります。

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

メモ この関数は互換性のためにのみ提供されます。 アプリケーションでは SymEnumSymbols を使用する必要があります。
 

構文

PSYM_ENUMSYMBOLS_CALLBACK64W PsymEnumsymbolsCallback64w;

BOOL PsymEnumsymbolsCallback64w(
  [in]           PCWSTR SymbolName,
  [in]           DWORD64 SymbolAddress,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

パラメーター

[in] SymbolName

記号の名前。 symSetOptions 関数で SYMOPT_UNDNAME オプションを使用する場合は、名前を解除できます。

[in] SymbolAddress

シンボルの先頭の仮想アドレス。

[in] SymbolSize

シンボルのサイズ (バイト単位)。 サイズは計算され、実際には最適な推定値です。 場合によっては、値を 0 にすることができます。

[in, optional] UserContext

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

戻り値

関数が TRUE を返した場合、列挙は続行されます。

関数が FALSE を返した場合、列挙体は停止します。

注釈

呼び出し元のアプリケーションは、すべてのシンボルが列挙されるまで、または列挙コールバック関数が FALSE を返すまで、シンボルごとに 1 回呼び出されます。

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMSYMBOLS_CALLBACK PSYM_ENUMSYMBOLS_CALLBACK64
#define PSYM_ENUMSYMBOLS_CALLBACKW PSYM_ENUMSYMBOLS_CALLBACK64W
#else
typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACK)(
    __in PCSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );

typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACKW)(
    __in PCWSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );
#endif

要件

要件 値
対象プラットフォーム Windows
ヘッダー dbghelp.h
再頒布可能パッケージ DbgHelp.dll 5.1 以降

こちらもご覧ください

DbgHelp 関数

SymEnumSymbols

SymEnumerateSymbols64