다음을 통해 공유

SetupWriteTextLogInfLine 함수(setupapi.h)

  • 아티클

SetupWriteTextLogInfLine 함수는 지정된 INF 파일 줄의 텍스트가 포함된 SetupAPI 텍스트 로그에 로그 항목을 씁니다.

구문

WINSETUPAPI VOID SetupWriteTextLogInfLine(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Flags,
  [in] HINF         InfHandle,
  [in] PINFCONTEXT  Context
);

매개 변수

[in] LogToken

시스템 정의 로그 토큰 이거나 SetupGetThreadLogToken에서 반환된 로그 토큰입니다.

[in] Flags

다음을 지정하는 플래그 값의 비트 OR인 DWORD 형식의 값입니다.

  • 로그 항목에 대한 이벤트 수준입니다. 로그 항목에 대해 지정할 수 있는 이벤트 수준은 텍스트 로그에 대해 사용하도록 설정할 수 있는 이벤트 수준과 동일합니다. 이벤트 수준 플래그 목록은 SetupAPI 텍스트 로그에 대한 이벤트 수준 설정을 참조하세요.
  • 로그 항목에 타임스탬프를 포함할지 여부입니다. 타임스탬프는 플래그 값이 TXTLOG_TIMESTAMP.
  • 섹션의 들여쓰기 깊이 및 현재 로그 항목에 대한 변경 내용(있는 경우)입니다. 들여쓰기 플래그를 사용하는 방법에 대한 자세한 내용은 들여쓰기 로그 항목 작성을 참조하세요.

[in] InfHandle

텍스트 로그에 쓸 텍스트 줄을 포함하는 INF 파일에 대한 핸들입니다. InF 파일에 대한 핸들은 Platform SDK에 설명된 SetupOpenInfFile을 호출하여 가져옵니다.

[in] Context

텍스트 로그에 쓸 텍스트 줄을 지정하는 INF 파일 컨텍스트에 대한 포인터입니다. 선에 대한 INF 파일 컨텍스트는 SetupFindXxxLine 함수를 호출하여 가져옵니다. INF 파일 및 INF 파일 컨텍스트에 대한 자세한 내용은 INF 파일 사용, INF 파일 컨텍스트 가져오기 및 INFCONTEXT 구조체에 대한 플랫폼 SDK에 제공된 정보를 참조하세요.

반환 값

없음

설명

SetupWriteTextLogInfLine 은 다음 형식으로 로그 항목을 작성합니다.

entry-prefixtime-stampinf:indentationinf-line-text(inf-file-nameline-number)

위치:

  • 항목 접두사 및 타임스탬프는텍스트 로그 섹션 본문 형식에 설명된 필드와 동일합니다.
  • inf-line-text 필드에는 지정된 INF 파일 줄의 텍스트가 포함됩니다.
  • inf-file-name 필드에는 지정된 INF 파일 줄이 포함된 INF 파일의 이름이 포함됩니다.
  • 줄 번호 필드에는 INF 파일에 지정된 줄의 줄 번호가 포함됩니다.
호출자가 제공하는 로그 토큰 및 플래그는 SetupWriteTextLog 및 SetupWriteTextLogError에 설명된 것과 동일한 방식으로 SetupWriteTextLogInfLine 작업에 영향을 줍니다. 또한 SetupWriteTextLogInfLine 은 이벤트 범주 TXTLOG_INF 사용합니다.

SetupAPI 텍스트 로그에서 로그 항목을 작성하는 방법에 대한 일반적인 내용은 SetupAPI 로깅(Windows Vista)을 참조하세요.

SetupWriteTextLogInfLine 작업에 대한 자세한 내용은 SetupWriteTextLogInfLine 호출을 참조하세요.

다양한 유형의 로그 토큰에 대한 자세한 내용은 로그 토큰을 참조하세요.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 setupapi.h(Setupapi.h 포함)
라이브러리 Setupapi.lib
DLL Setupapi.dll

추가 정보

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError