ホーム › System.Diagnostics.Debug › PGET_TARGET_ATTRIBUTE_VALUE64

PGET_TARGET_ATTRIBUTE_VALUE64

コールバック

シグネチャ

BOOL PGET_TARGET_ATTRIBUTE_VALUE64(
    HANDLE hProcess,
    DWORD Attribute,
    ULONGLONG AttributeData,
    ULONGLONG* AttributeValue
);

パラメーター

フィールド

型

説明

hProcess

HANDLE

スタックトレースの生成対象となるプロセスのハンドル。

Attribute

DWORD

要求されている属性を示す数値。現在定義されている値は次のとおりです。

名前	値
TARGET_ATTRIBUTE_PACMASK (0x01)	スタックウォーカーが、スタックをウォークしている対象プロセスの ARM64 ポインター認証 (PAC) マスクを要求していることを示します。

この属性が要求された場合、AttributeData パラメーターは、PAC マスクを取得する対象のアドレスを示します。これにより、EL0/1/2 (ユーザーモードとカーネルモードなど) の PAC マスクを区別できます。

PAC が無効になっている場合 (またはスタックウォークの対象が ARM64 プラットフォームでない場合)、実装はこの属性を提供できないことを示す FALSE を返す必要があります。

特別な値 TARGET_ATTIBUTE_PACMASK_LIVETARGET (0xffffffffffffffff) を返すことで、PAC マスクが StackWalk2 を呼び出しているプロセスと同じであることを示せます。

AttributeData

ULONGLONG

Attribute パラメーターに関連付けられたデータ値。このパラメーターの意味は、要求されている属性によって異なります。

AttributeValue

ULONGLONG*

コールバックの実装は、成功を返す前に、要求された属性の値をここに格納する必要があります。

公式ドキュメント

StackWalk2 関数と共に使用されるアプリケーション定義のコールバック関数です。スタックウォークに必要なターゲット属性の値を提供します。

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

戻り値

この関数は、属性値が AttributeValue 出力パラメーターに正常に格納されたかどうかを返します。指定された属性が認識されない場合、または対象のプラットフォームに関係がない場合、関数は FALSE を返す必要があります。

解説(Remarks)

typedef
BOOL
(__stdcall *PGET_TARGET_ATTRIBUTE_VALUE64)(
    _In_ HANDLE hProcess,
    _In_ DWORD Attribute,
    _In_ DWORD64 AttributeData,
    _Out_ DWORD64 *AttributeValue
    );

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)