IDebugFailureAnalysis：：GetUlong64 方法（extsfns.h）

發行項
02/06/2025

GetUlong64 方法會搜尋具有指定標籤之第一個 FA 專案物件的 DebugFailureAnalysis 物件。如果找到具有指定標籤的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，而且不會取得數據區塊。

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

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