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

Статья
02/26/2024

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