IDebugFailureAnalysis2::SetUlong64 메서드(extsfns.h)

아티클
02/26/2024

SetUlong64 메서드는 지정된 태그가 있는 첫 번째 FA 항목에 대해 DebugFailureAnalysis 개체를 검색합니다. 지정된 태그가 있는 FA 항목을 찾으면 FA 항목의 데이터 블록을 지정된 ULONG64 값으로 설정(덮어쓰기)합니다. 이 메서드는 지정된 태그가 있는 FA 항목을 찾지 못하면 해당 태그를 사용하여 새 FA 항목을 만들고 새 FA 항목의 데이터 블록을 지정된 ULONG64 값으로 설정합니다.

구문

PFA_ENTRY SetUlong64(
       FA_TAG  Tag,
  [in] ULONG64 Value
);

매개 변수

Tag

FA_TAG 열거형의 값입니다.

[in] Value

새 FA 항목 또는 기존 FA 항목의 데이터 블록에 쓸 ULONG64 값입니다.

반환 값

이 메서드가 성공하면 새 구조체 또는 기존 FA_ENTRY 구조체에 대한 포인터를 반환합니다. 그렇지 않으면 NULL을 반환합니다.

설명

이 메서드는 지정된 태그가 있는 FA 항목을 찾으면 해당 태그와 연결된 데이터 형식이 DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSET 또는 DEBUG_FA_ENTRY_POINTER 여부를 확인합니다. 태그와 연결된 데이터 형식에 이러한 세 값 중 하나가 없으면 이 메서드는 NULL을 반환하고 항목의 데이터 블록을 덮어쓰지 않습니다.

이 메서드는 지정된 태그가 있는 FA 항목을 찾지 못하면 해당 태그가 있는 새 FA 항목을 만들고 태그를 데이터 형식 DEBUG_FA_ENTRY_ULONG64 연결합니다.