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

Статья
08/07/2023

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

Синтаксис

PFA_ENTRY GetUlong64(
        FA_TAG   Tag,
  [out] PULONG64 Value
);

Параметры

Tag

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

[out] Value

Указатель на ULONG64 , получающий значение из блока данных записи.

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

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

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

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

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