Partager via

PGET_TARGET_ATTRIBUTE_VALUE64 fonction de rappel (dbghelp.h)

  • Article

Fonction de rappel définie par l’application utilisée avec la fonction StackWalk2. Il fournit des valeurs d’attribut cible requises pour la procédure de pile.

Le type PGET_TARGET_ATTRIBUTE_VALUE64 définit un pointeur vers cette fonction de rappel. GetTargetAttributeValueProc64 est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

PGET_TARGET_ATTRIBUTE_VALUE64 PgetTargetAttributeValue64;

BOOL PgetTargetAttributeValue64(
  [in]  HANDLE hProcess,
  [in]  DWORD Attribute,
  [in]  DWORD64 AttributeData,
  [out] DWORD64 *AttributeValue
)
{...}

Paramètres

[in] hProcess

Handle vers le processus pour lequel la trace de pile est générée.

[in] Attribute

Valeur numérique indiquant ce qu’atttribute est demandé. Les valeurs actuellement définies sont les suivantes :

Nom Valeur
TARGET_ATTRIBUTE_PACMASK (0x01) Indique que le marcheur de pile demande le masque d’authentification du pointeur ARM64 pour le processus dont la pile est en cours de marche.

Si cet attribut est demandé, le paramètre AttributeData indique l’adresse pour laquelle le masque PAC est récupéré. Cela permet une différenciation entre les masques PAC pour EL0/1/2 (mode utilisateur et mode noyau, etc.).

Si PAC est désactivé (ou si la procédure de pile n’est pas destinée à une plateforme ARM64), l’implémentation doit retourner FALSE indiquant que cet attribut ne peut pas être fourni.

La valeur spéciale TARGET_ATTIBUTE_PACMASK_LIVETARGET (0xffffffff’ffffffff) peut être retournée comme indication que le masque PAC est identique au processus appelant StackWalk2.

[in] AttributeData

Valeur de données associée au paramètre Attribut. La signification de ce paramètre varie en fonction de l’attribut demandé.

[out] AttributeValue

L’implémentation du rappel doit placer la valeur de l’attribut demandé ici avant de retourner la réussite.

Valeur de retour

La fonction retourne si la valeur de l’attribut a été correctement stockée dans le paramètre de sortie AttributeValue. Si l’attribut donné n’est pas reconnu ou n’est pas pertinent pour la plateforme en question, la fonction doit retourner FALSE.

Remarques

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

Exigences

Exigence Valeur
plateforme cible Windows
d’en-tête dbghelp.h
redistribuable DbgHelp.dll 10.0.22621.4602 ou version ultérieure

Voir aussi