Метод IDebugFailureAnalysis2::SetString (extsfns.h)

Метод SetString выполняет поиск объекта DebugFailureAnalysis для первой записи FA с указанным тегом. Если он находит запись FA с указанным тегом, он задает (перезаписывает) блок данных записи FA в указанное строковое значение. Если этот метод не находит запись FA с указанным тегом, она создает новую запись FA с этим тегом и задает блок данных новой записи FA в указанное строковое значение.

Синтаксис

PFA_ENTRY SetString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

Параметры

Tag

Значение в перечислении FA_TAG.

[in] Str

Указатель на строку ANSI, завершаемую значением NULL, для записи в блок данных новой или существующей записи FA.

Возвращаемое значение

Если этот метод выполнен успешно, он возвращает указатель на новую или существующую FA_ENTRY структуру. В противном случае возвращается NULL.

Замечания

Если этот метод находит запись FA с указанным тегом, проверяет, является ли тип данных, связанный с этим тегом, DEBUG_FA_ENTRY_ANSI_STRING или DEBUG_FA_ENTRY_EXTENSION_CMD. Если тип данных, связанный с тегом, не является одним из этих двух типов, этот метод возвращает NULL и не перезаписывает блок данных записи.

Если этот метод не находит запись FA с указанным тегом, она создает новую запись FA с этим тегом и связывает тег с типом данных DEBUG_FA_ENTRY_ANSI_STRING.

Требования

См. также

AddString

IDebugFailureAnalysis2

написание подключаемого модуля расширения анализа для расширения !analysis

_EFN_Analyze