텍스트 로그 섹션 본문의 형식

텍스트 로그 섹션 본문에는 텍스트 로그 섹션과 연결된 작업에 적용되는 0개 이상의 로그 항목이 포함되어 있습니다. 섹션 본문 로그 항목의 형식에는 다음과 같이 entry_prefix 필드, time_stamp 필드, event_category 필드, 들여쓰기 필드 및 formatted_message 필드가 포함됩니다.

entry_prefix time_stamp event_category 들여쓰기 formatted_message
섹션 본문 로그 항목의 최대 길이(문자)는 336입니다.

entry_prefix 필드
로그 항목이 오류 메시지, 경고 메시지 또는 정보 메시지인지 여부를 나타냅니다. entry_prefix 필드는 항상 존재하며 다음 표에 나열된 문자열 중 하나를 포함합니다.

Entry_prefix 필드	메시지 유형
"!!!    "	오류 메시지
"!      "	경고 메시지
" "	오류 메시지 또는 경고 메시지 이외의 정보 메시지

time_stamp 필드
기록된 이벤트가 발생한 시스템 시간을 나타냅니다. time_stamp 필드는 선택 사항이며 SetupAPI에는 기본적으로 타임스탬프를 포함하지 않습니다. 그러나 SetupWriteTextLog 는 로그 항목에 타임스탬프를 포함할 수 있습니다. time_stamp 필드의 형식은 텍스트 로그 섹션 머리글 형식에 설명된 time_stamp 필드의 형식과 동일합니다.

event_category 필드
로그 항목을 만든 SetupAPI 작업의 범주를 나타냅니다. event_category 필드는 일반적으로 존재하지만 필수는 아닙니다. event_category 필드가 있으면 다음 표에 나열된 문자열 중 하나가 포함됩니다.

필드 문자열 Event_category	SetupAPI 작업
"...: "	공급업체에서 제공하는 작업
"박: "	백업 데이터
"cci: "	클래스 설치 관리자 또는 공동 설치 관리자 작업
"cpy: "	파일 복사
"dvi: "	장치 설치
"flq: "	파일 큐 관리
"inf: "	INF 파일 관리
"ndv: "	새 디바이스 마법사
"prp: "	디바이스 및 드라이버 속성 관리
"reg: "	레지스트리 설정 관리
"set: "	일반 설정
"sig: "	디지털 서명 확인
"sto: "	드라이버 저장소 관리
"ui: "	사용자 인터페이스 관리 대화 상자
"ump: "	사용자 모드 PnP 관리자

들여쓰기 필드
들여쓰기 단위가 5개의 공백을 포함하는 모노스페이스 문자열인 0개 이상의 들여쓰기 단위 시퀀스로 구성됩니다. 들여쓰기 필드는 선택 사항이며 SetupAPI에는 기본적으로 들여쓰기가 포함되지 않습니다. SetupWriteTextLog 는 로그 항목에 포함된 들여쓰기 단위 수를 변경할 수 있도록 지원합니다.

formatted_message 필드
로그 항목에 적용되는 특정 정보를 포함합니다.

기록되는 섹션 본문 항목은 로그에 대해 설정된 이벤트 수준 및 로그에 대해 사용하도록 설정된 범주 수준에 따라 달라집니다. 이러한 설정에 대한 자세한 내용은 SetupAPI 로깅 레지스트리 설정을 참조하세요.

SetupAPI는 디바이스 설치에 적용되는 작업을 그룹화하는 섹션을 만들 때 하위 섹션에서 섹션 본문 로그 항목을 재귀적으로 그룹화합니다. SetupAPI는 로그 항목에 주석을 달고 들여쓰는 방식으로 하위 섹션을 구분합니다. 이러한 하위 섹션 중 하나는 일반적인 디바이스 설치 섹션에서 발췌한 다음 섹션에 나타납니다. 하위 섹션은 로그 항목 "dvi: {Build Driver List}"로 시작하고 로그 항목 "dvi: {Build Driver List - exit(0x00000000)}"로 끝납니다. 이 하위 섹션에서는 entry_prefix, event_category, 들여쓰기및formatted_message 필드를 포함하는 일반적인 로그 항목 시퀀스를 보여 줍니다. 로그 항목을 작성한 SetupAPI 작업에서도 들여쓰기를 만들고 형식이 지정된 메시지의 콘텐츠를 제공했습니다. 이 예제의 이벤트 수준은 TXTLOG_DETAILS 설정되었으며 이 예제에서는 모든 범주 수준을 사용하도록 설정했습니다.

>>>  [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>>  2005/02/13 22:06:28.109: Section start
...
 Additional section body log entries
...
     dvi: {Build Driver List}
     dvi:      Enumerating all INFs...
     dvi:      Found driver match:
     dvi:           HardwareID - PCI\VEN_104C&DEV_8019
     dvi:           InfName    - C:\WINDOWS\inf\1394.inf
     dvi:           DevDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           DrvDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           Provider   - Microsoft
     dvi:           Mfg        - Texas Instruments
     dvi:           InstallSec - TIOHCI_Install
     dvi:           ActualSec  - TIOHCI_Install.NT
     dvi:           Rank       - 0x00002001
     dvi:           DrvDate    - 10/01/2002
     dvi:           Version    - 6.0.5033.0 
!!!  inf:      InfCache: Error flagging 1394.inf for match string pci\ven_104c&dev_8019
     dvi: {Build Driver List - exit(0x00000000)}
...
 Additional section body log entries 
...
<<<  [2005/02/13 22:06:29.000: Section end]
<<<  [Exit Status(0x00000000)]