SetupWriteTextLog 호출

  • 아티클

SetupWriteTextLog 는 설치 이벤트에 대한 정보가 포함된 단일 항목을 SetupAPI 텍스트 로그에 추가합니다.

텍스트 로그 섹션 본문 형식에 설명된 대로 로그 항목의 형식은 다음 필드로 구성됩니다.

entry_prefix time_stamp event_category indentation formatted_message

SetupWriteTextLog를 호출하기 위해 애플리케이션은 다음 정보를 제공합니다.

  • SetupGetThreadLogToken 또는 시스템 정의 로그 토큰 중 하나를 호출하여 가져온 텍스트 로그의 섹션에 대한 로그 토큰입니다. 로그 토큰이 텍스트 로그 섹션과 연결된 경우 SetupWriteTextLog 는 해당 섹션에 로그 항목을 씁니다. 그렇지 않으면 SetupWriteTextLog 는 로그 항목을 텍스트 로그 섹션에 포함되지 않은 로그의 일부에 추가합니다. 또한 SetupWriteTextLog 가 로그 항목을 쓰는지 여부와 SetupWriteTextLog 가 항목을 쓰는 텍스트 로그는 시스템 정의 로그 토큰 값에 따라 달라집니다.

    로그 토큰에 대한 자세한 내용은 스레드에 대한 로그 토큰 설정 및 가져오기를 참조하세요.

  • 텍스트 로그에 이벤트 범주 사용에서 설명하는 이벤트 범주 중 하나입니다. 항목에 대한 이벤트 범주가 텍스트 로그에 대해 사용하도록 설정된 경우 SetupWriteTextLog 는 텍스트 로그에 항목을 추가합니다. 그렇지 않으면 SetupWriteTextLog 가 텍스트 로그에 항목을 쓰지 않습니다.

  • 이벤트 수준, 들여쓰기 깊이 및 타임스탬프를 포함할지 여부를 지정하는 시스템 정의 상수의 비트 OR인 플래그 값입니다. 이벤트 수준은 텍스트 로그에 대한 이벤트 수준 설정에 설명되어 있습니다. 텍스트 로그에 대해 설정된 이벤트 수준이 항목의 이벤트 수준보다 크거나 같으면 SetupWriteTextLog 는 로그 항목을 텍스트 로그에 씁니다. 그렇지 않으면 SetupWriteTextLog 는 텍스트 로그에 로그 항목을 쓰지 않습니다. 들여쓰기를 사용하면 섹션의 정보를 더 쉽게 읽고 이해할 수 있도록 서식이 지정된 메시지를 정렬할 수 있습니다. 자세한 내용은 들여쓰기 로그 항목 작성을 참조하세요.

  • 메시지와 형식 문자열 뒤에 있는 쉼표로 구분된 변수 목록의 서식을 모두 지정하는 printf 호환 형식 문자열입니다.

  • printf 호환 형식 문자열로 형식이 지정된 쉼표로 구분된 변수 목록입니다.

SetupWriteTextLog를 호출하여 오류 또는 경고가 아닌 이벤트에 대한 정보를 기록하는 방법에 대한 예제는 정보 로그 항목 작성을 참조하세요.

SetupWriteTextLog를 호출하여 오류 또는 경고에 대한 정보를 기록하는 방법에 대한 예제는 오류 또는 경고 로그 항목 작성을 참조하세요.