IDebugFailureAnalysis2::AddString 方法 (extsfns.h)
AddString 方法會將新的FA專案新增至DebugFailureAnalysis物件,並將FA專案的數據區塊設定為指定的字串。
語法
PFA_ENTRY AddString(
FA_TAG Tag,
[in] PCSTR Str
);
參數
Tag
FA_TAG 列舉中的值。 與這個標籤相關聯的數據類型必須 DEBUG_FA_ENTRY_ANSI_STRING。
[in] Str
要寫入新 FA專案之數據區塊之 Null 終止 ANSI 字串的指標。
傳回值
如果此方法成功,它會傳回新 FA_ENTRY 結構的指標。 如果此方法失敗,則會傳回 NULL。
備註
這個方法會將新FA_ENTRY結構的 DataSize 成員設定為包含 NULL 終止符的字串長度,以位元組為單位。
每個標記都會與 FA_ENTRY_TYPE 列舉中的其中一個數據類型相關聯。 若要判斷與標記相關聯的數據類型,請呼叫 IDebugFAEntryTags 介面的 GetType 方法。
若要取得 IDebugFAEntryTags 介面的指標,請呼叫 IDebugFailureAnalysis2 介面的 GetDebugFATagControl 方法。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | extsfns.h |