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

아티클
02/26/2024

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

구문

PFA_ENTRY SetString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

매개 변수

Tag

FA_TAG 열거형의 값입니다.

[in] Str

새 FA 항목 또는 기존 FA 항목의 데이터 블록에 쓸 null로 끝나는 ANSI 문자열에 대한 포인터입니다.

반환 값

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

설명

이 메서드는 지정된 태그가 있는 FA 항목을 찾으면 해당 태그와 연결된 데이터 형식이 DEBUG_FA_ENTRY_ANSI_STRING 또는 DEBUG_FA_ENTRY_EXTENSION_CMD 여부를 확인합니다. 태그와 연결된 데이터 형식이 이러한 두 형식 중 하나가 아닌 경우 이 메서드는 NULL 을 반환하고 항목의 데이터 블록을 덮어쓰지 않습니다.

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