Метод IDebugFailureAnalysis::GetString (extsfns.h)

Метод GetString выполняет поиск объекта DebugFailureAnalysis для первой записи FA с указанным тегом. Если он находит запись 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. Чтобы определить тип данных, связанный с тегом, вызовите метод GetType интерфейса IDebugFAEntryTags. Чтобы получить указатель на интерфейс IDebugFAEntryTags, вызовите метод GetDebugFATagControl интерфейса IDebugFailureAnalysis2.

Соответствующее использование этого метода — получение блока данных из записи FA с типом данных DEBUG_FA_ENTRY_ANSI_STRING.

Требования

См. также

AddString

IDebugFailureAnalysis2

SetString

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

_EFN_Analyze