Share via

SetupWriteTextLogError 함수(setupapi.h)

  • 아티클

SetupWriteTextLogError 함수는 SetupAPI 관련 오류 또는 Win32 시스템 오류에 대한 정보를 SetupAPI 텍스트 로그에 씁니다.

구문

WINSETUPAPI VOID SetupWriteTextLogError(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Category,
  [in] DWORD        LogFlags,
  [in] DWORD        Error,
  [in] PCSTR        MessageStr,
       ...          
);

매개 변수

[in] LogToken

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

[in] Category

로그 항목의 이벤트 범주를 나타내는 DWORD 형식의 값입니다. 로그 항목에 대해 지정할 수 있는 이벤트 범주는 텍스트 로그에 대해 사용하도록 설정할 수 있는 이벤트 범주와 동일합니다. 이벤트 범주 목록은 SetupAPI 텍스트 로그에 이벤트 범주 사용을 참조하세요.

[in] LogFlags

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

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

[in] Error

SetupAPI 관련 오류 코드 또는 Win32 오류 코드입니다. SetupAPI 관련 오류 코드는 Setupapi.h에 나열됩니다. Win32 오류 코드는 Winerror.h에 나열됩니다.

[in] MessageStr

로그 항목에 포함할 서식이 지정된 메시지를 지정하는 printf 호환 형식 문자열을 포함하는 NULL로 끝나는 상수 문자열에 대한 포인터입니다.

...

MessageStr에서 제공하는 형식 문자열의 형식 지정자와 일치하는 쉼표로 구분된 매개 변수 목록입니다.

반환 값

없음

설명

설치 애플리케이션에 설치 오류 코드 또는 설치 오류와 연결된 Win32 오류 코드가 있는 경우 애플리케이션은 SetupWriteTextLog 대신 SetupWriteTextLogError를 호출하여 두 항목을 텍스트 로그에 쓸 수 있습니다. 첫 번째 항목은 SetupWriteTextLog 에서 작성한 항목과 동일하며 두 번째 항목은 오류 코드와 오류에 대한 사용자에게 친숙한 설명을 기록합니다.

호출자가 제공하는 로그 토큰, 이벤트 범주 및 플래그는 SetupWriteTextLogError 의 작업에 영향을 줍니다. SetupWriteTextLog에 대해 설명한 것과 동일합니다.

SetupWriteTextLogError 는 다음 형식으로 첫 번째 로그 항목을 씁니다.

entry-prefixtime_stamp 범주들여쓰기formatted-message

SetupWriteTextLogError 는 두 번째 로그 항목을 다음 형식으로 작성합니다.

entry-prefixtime_stamp범주들여쓰기오류:error-numbererror-description

위치:

  • 항목 접두사, 타임스탬프를, 범주, 들여쓰기 및 서식이 지정된 메시지 필드는 텍스트 로그 섹션 본문의 형식에 설명된 필드와 동일합니다.
  • 오류 번호 필드에는 오류 번호가 포함됩니다.
  • 오류 설명 필드에는 오류에 대한 사용자에게 친숙한 설명이 포함되어 있습니다.
SetupAPI 텍스트 로그에서 로그 항목을 작성하는 방법에 대한 일반적인 내용은 SetupAPI 로깅(Windows Vista)을 참조하세요.

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

로그 토큰에 대한 자세한 내용은 로그 토큰을 참조하세요.

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

요구 사항

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

추가 정보

SetupGetThreadLogToken

SetupWriteTextLog