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

Статья
02/26/2024

Метод GetUlong ищет в объекте DebugFailureAnalysis первую запись FA с указанным тегом. Если обнаруживается запись FA с указанным тегом, она получает строковое значение ANSI из блока данных записи.

Синтаксис

PFA_ENTRY GetUlong(
  [in]  FA_TAG Tag,
  [out] PULONG Value
);

Параметры

[in] Tag

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

[out] Value

Указатель на буфер, который получает строковое значение из блока данных записи.

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

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

Этот метод копирует строку, завершаемую нулевым значением, из блока данных записи в буфер, на который указывает Str. Этот метод копирует не более символов MaxSize , включая признак конца NULL.

Каждый тег, который уже использовался в объекте DebugFailureAnalysis , связан с одним из типов данных в перечислении FA_ENTRY_TYPE . Чтобы определить тип данных, связанный с тегом, вызовите метод GetType интерфейса IDebugFAEntryTags . Чтобы получить указатель на интерфейс IDebugFAEntryTags, вызовите метод GetDebugFATagControl интерфейса IDebugFailureAnalysis2 .

Этот метод можно использовать для получения блока данных из записи FA с типом данных DEBUG_FA_ENTRY_ANSI_STRING.