Metodo IDebugFailureAnalysis::GetUlong64 (extsfns.h)

Articolo
03/05/2024

Il metodo GetUlong64 cerca un oggetto DebugFailureAnalysis per la prima voce FA con un tag specificato. Se trova una voce FA con il tag specificato, ottiene il valore ULONG64 dal blocco di dati della voce.

Sintassi

PFA_ENTRY GetUlong64(
        FA_TAG   Tag,
  [out] PULONG64 Value
);

Parametri

Tag

Valore nell'enumerazione FA_TAG .

[out] Value

Puntatore a un ULONG64 che riceve il valore dal blocco di dati della voce.

Valore restituito

Se questo metodo trova una voce FA con il tag specificato e se riesce a ottenere il blocco di dati, restituisce un puntatore alla struttura FA_ENTRY . In caso contrario, restituisce NULL.

Commenti

Se questo metodo trova una voce FA con il tag specificato, verifica se il membro DataSize della struttura FA_ENTRY è uguale alla dimensione di un ULONG64. Se DataSize non è uguale alla dimensione di un ULONG64, questo metodo restituisce NULL e non ottiene il blocco di dati.

Ogni tag già utilizzato in un oggetto DebugFailureAnalysis è associato a uno dei tipi di dati nell'enumerazione FA_ENTRY_TYPE . Per determinare il tipo di dati associato a un tag, chiamare il metodo GetType dell'interfaccia IDebugFAEntryTags . Per ottenere un puntatore a un'interfaccia IDebugFAEntryTags, chiamare il metodo GetDebugFATagControl dell'interfaccia IDebugFailureAnalysis2 .

L'uso appropriato di questo metodo è ottenere il blocco di dati da una voce FA con tipo di dati di DEBUG_FA_ENTRY_ULONG64 o DEBUG_FA_ENTRY_INSTRUCTION_OFFSET o DEBUG_FA_ENTRY_POINTER.