IDebugFailureAnalysis2::SetString 方法 (extsfns.h)
SetString 方法會搜尋具有指定標記的第一個 FA 專案DebugFailureAnalysis 物件。 如果找到具有指定標籤的FA專案,則會將FA專案的數據區塊設定為指定的字串值。 如果此方法找不到具有指定標記的 FA 專案,它會使用該標記建立新的FA專案,並將新FA專案的數據區塊設定為指定的字串值。
語法
PFA_ENTRY SetString(
FA_TAG Tag,
[in] PCSTR Str
);
參數
Tag
FA_TAG 列舉中的值。
[in] Str
要寫入新或現有 FA 專案之資料區塊之 null 終止 ANSI 字串的指標,。
傳回值
如果此方法成功,它會傳回新或現有 FA_ENTRY 結構的指標。 否則,它會傳回NULL 。
言論
如果此方法找到具有指定標籤的 FA 專案,它會檢查與該標籤相關聯的數據類型是否為 DEBUG_FA_ENTRY_ANSI_STRING 或 DEBUG_FA_ENTRY_EXTENSION_CMD。 如果與標記相關聯的數據類型不是這兩種類型的其中一種,這個方法會傳回 NULL,而且不會覆寫專案的數據區塊。
如果此方法找不到具有指定標籤的 FA 專案,則會使用該標記建立新的FA專案,並將標記與資料類型產生關聯 DEBUG_FA_ENTRY_ANSI_STRING。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | extsfns.h |