Leggere in inglese

Condividi tramite

PGET_TARGET_ATTRIBUTE_VALUE64 funzione di callback (dbghelp.h)

  • Articolo

Funzione di callback definita dall'applicazione usata con la funzione StackWalk2. Fornisce valori di attributo di destinazione necessari per la procedura dettagliata dello stack.

Il tipo PGET_TARGET_ATTRIBUTE_VALUE64 definisce un puntatore a questa funzione di callback. getTargetAttributeValueProc64 è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PGET_TARGET_ATTRIBUTE_VALUE64 PgetTargetAttributeValue64;

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

Parametri

[in] hProcess

Handle per il processo per il quale viene generata l'analisi dello stack.

[in] Attribute

Valore numerico che indica quale atttribute viene richiesto. I valori attualmente definiti sono:

Nome Valore
TARGET_ATTRIBUTE_PACMASK (0x01) Indica che lo stack walker richiede la maschera di autenticazione del puntatore ARM64 per il processo il cui stack viene camminato.

Se questo attributo viene richiesto, il parametro AttributeData indicherà l'indirizzo per cui viene recuperata la maschera PAC. Ciò consente una differenziazione tra le maschere PAC per EL0/1/2 (modalità utente rispetto alla modalità kernel e così via).

Se PAC è disabilitato (o lo stack walk non è per una piattaforma ARM64), l'implementazione deve restituire FALSE che indica che questo attributo non può essere fornito.

Il valore speciale TARGET_ATTIBUTE_PACMASK_LIVETARGET (0xffffffff'ffffffff) può essere restituito come indicazione che la maschera PAC corrisponde al processo che chiama StackWalk2.

[in] AttributeData

Valore di dati associato al parametro attribute. Il significato di questo parametro varia a seconda dell'attributo richiesto.

[out] AttributeValue

L'implementazione del callback deve inserire qui il valore dell'attributo richiesto prima di restituire l'esito positivo.

Valore restituito

La funzione restituisce se il valore dell'attributo è stato archiviato correttamente nel parametro di output AttributeValue. Se l'attributo specificato non viene riconosciuto o è irrilevante per la piattaforma in questione, la funzione deve restituire FALSE.

Osservazioni

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

Fabbisogno

Requisito Valore
piattaforma di destinazione Finestre
intestazione dbghelp.h
Ridistribuibile DbgHelp.dll 10.0.22621.4602 o versione successiva

Vedere anche