IDebugFailureAnalysis：：GetString 方法（extsfns.h）

發行項
02/06/2025

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

語法

PFA_ENTRY GetString(
  [in]  FA_TAG Tag,
  [out] PSTR   Str,
  [in]  ULONG  MaxSize
);

參數

[in] Tag

FA_TAG 列舉中的值。

[out] Str

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

[in] MaxSize

Str 所指向之緩衝區的大小，以位元組為單位，。

傳回值

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

言論

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

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

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