IDebugFailureAnalysis：：GetUlong64 方法 (extsfns.h)

發行項
02/26/2024

GetUlong64 方法會在DebugFailureAnalysis物件中搜尋具有指定標記的第一個FA專案。如果找到具有指定標籤的FA專案，它會從專案的數據區塊取得 ULONG64 值。

語法

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

參數

Tag

FA_TAG 列舉中的值。

[out] Value

從項目的數據區塊接收值的 ULONG64 指標。

傳回值

如果這個方法找到具有指定標籤的 FA專案，如果成功取得數據區塊，則會傳回 FA_ENTRY 結構的指標。否則，它會傳回 NULL。

備註

如果這個方法找到具有指定標籤的FA專案，它會檢查FA_ENTRY結構的DataSize成員是否等於ULONG64的大小。如果 DataSize 不等於 ULONG64的大小，這個方法會傳回 NULL ，而且不會取得數據區塊。

偵錯FailureAnalysis 對象中已經使用的每個標記，都會與 FA_ENTRY_TYPE 列舉中的其中一個數據類型相關聯。若要判斷與標記相關聯的數據類型，請呼叫 IDebugFAEntryTags 介面的 GetType 方法。若要取得 IDebugFAEntryTags 介面的指標，請呼叫 IDebugFailureAnalysis2 介面的 GetDebugFATagControl 方法。

此方法的適當用法是從具有數據類型為 DEBUG_FA_ENTRY_ULONG64 或 DEBUG_FA_ENTRY_INSTRUCTION_OFFSET 或 DEBUG_FA_ENTRY_POINTER 的FA專案取得數據區塊。