IDebugFailureAnalysis：：GetUlong 方法 (extsfns.h)

發行項
02/29/2024

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

語法

PFA_ENTRY GetUlong(
  [in]  FA_TAG Tag,
  [out] PULONG Value
);

參數

[in] Tag

FA_TAG 列舉中的值。

[out] Value

緩衝區的指標，從專案的數據區塊接收字串值。

傳回值

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

備註

這個方法會將 Null 終止的字串從專案的數據區塊複製到 Str 所指向的緩衝區。這個方法最多會複製 MaxSize 字元，包括 NULL 終止符。

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

此方法的適當用法是從數據類型為 DEBUG_FA_ENTRY_ANSI_STRING的FA專案取得數據區塊。