IDebugFailureAnalysis2：：SetExtensionCommand 方法 (extsfns.h)

發行項
02/26/2024

SetExtensionCommand 方法會在 DebugFailureAnalysis 物件中搜尋具有指定標記的第一個 FA 專案。如果找到具有指定標籤的FA專案，它會將 (覆寫) FA專案的數據區塊設為指定的擴充命令字串。如果這個方法找不到具有指定標籤的 FA專案，它會使用該標記建立新的FA專案，並將新FA專案的數據區塊設定為指定的擴充命令字串。

語法

PFA_ENTRY SetExtensionCommand(
  FA_TAG Tag,
  PCSTR  Extension
);

參數

Tag

FA_TAG 列舉中的值。

Extension

延伸模組命令之 Null 終止字串的指標。擴充命令的範例是 “！analyze -v”。

傳回值

如果此方法成功，它會傳回新的或現有 FA_ENTRY 結構的指標。否則會傳回 NULL。

備註

如果此方法找到具有指定標籤的 FA專案，它會檢查與該標籤相關聯的數據類型是否 DEBUG_FA_ENTRY_EXTENSION_CMD 或 DEBUG_FA_ENTRY_ANSI_STRING。如果與標記相關聯的數據類型沒有這兩個值之一，這個方法會傳回 NULL ，而且不會覆寫專案的數據區塊。

如果此方法找不到具有指定標籤的 FA專案，它會使用該標記建立新的FA專案，並將標記與數據類型 產生關聯DEBUG_FA_ENTRY_EXTENSION_CMD。