SymRegisterCallbackW64

シンボルハンドラが使用するコールバック関数を登録する。(SymRegisterCallbackW64)

SymRegisterCallbackW64 hProcess, CallbackFunction, UserContext

hProcess : [intptr] もともと SymInitialize 関数に渡したプロセスのハンドル。
CallbackFunction : [int] SymRegisterCallbackProc64 コールバック関数。
UserContext : [int64] ユーザー定義の値または NULL。この値はそのままコールバック関数に渡される。通常、アプリケーションはこのパラメータを使用して、コールバック関数がコンテキストを確立するためのデータ構造へのポインタを渡す。

(プラグイン / モジュール : dbghelp.dll)

解説

シンボルハンドラが使用するコールバック関数を登録する。(SymRegisterCallbackW64)

[戻り値]
関数が成功した場合、戻り値は TRUE である。関数が失敗した場合、戻り値は FALSE
である。拡張エラー情報を取得するには、GetLastError を呼び出す。

[備考]
SymRegisterCallback64
関数を使用すると、アプリケーションはシンボルハンドラが使用するコールバック関数を登録できる。シンボルハンドラはアプリケーションに対する状態や進行情報があるときに、登録されたコールバック関数を呼び出す。この関数を含め、すべての
DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。SymRegisterCallbackW64
は Dbghelp.h で次のように定義されている。
（以下省略）

情報