다음을 통해 공유

SetupWriteTextLog 함수(setupapi.h)

  • 아티클

SetupWriteTextLog 함수는 SetupAPI 텍스트 로그에 로그 항목을 씁니다.

구문

WINSETUPAPI VOID SetupWriteTextLog(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Category,
  [in] DWORD        Flags,
  [in] PCSTR        MessageStr,
       ...          
);

매개 변수

[in] LogToken

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

[in] Category

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

[in] Flags

플래그 값의 비트 OR인 DWORD 형식 값으로, 다음을 지정합니다.

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

[in] MessageStr

로그 항목에 포함할 형식이 지정된 메시지를 지정하는 printf 호환 형식 문자열을 포함하는 NULL로 끝나는 상수 문자열에 대한 포인터입니다. MessageStr 뒤에 있는 쉼표로 구분된 매개 변수 목록은 형식 문자열의 형식 지정자와 일치해야 합니다.

...

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

반환 값

없음

설명

SetupGetThreadLogToken 호출에서 LogToken 값을 반환하고 해당 텍스트 로그 섹션을 찾을 수 있는 경우 SetupWriteTextLog는 해당 텍스트 로그 섹션에 로그 항목을 씁니다. SetupWriteTextLog에서 섹션을 찾을 수 없는 경우 SetupWriteTextLog는 해당 텍스트 로그에 로그 항목을 작성하지만 섹션에 로그 항목은 포함하지 않습니다.

LogToken 값이 다음 표에 나열된 시스템 정의 로그 토큰 중 하나인 경우 SetupWriteTextLog는 해당 로그 토큰에 대해 표시된 쓰기 작업을 수행합니다.

시스템 정의 로그 토큰 쓰기 작업
LOGTOKEN_NOLOG 로그 항목은 텍스트 로그에 기록되지 않습니다.
LOG_TOKEN_UNSPECIFIED 로그 항목은 애플리케이션 설치 텍스트 로그에 기록됩니다. 로그 항목은 텍스트 로그 섹션에 포함되지 않습니다.
LOGTOKEN_SETUPAPI_APPLOG 로그 항목은 애플리케이션 설치 텍스트 로그에 기록됩니다. 로그 항목은 텍스트 로그 섹션에 포함되지 않습니다.
LOGTOKEN_SETUPAPI_DEVLOG 로그 항목은 디바이스 설치 텍스트 로그에 기록됩니다. 로그 항목은 텍스트 로그 섹션에 포함되지 않습니다.
 
참고LogToken 값을 시스템 정의 로그 토큰 중 하나로 설정해도 스레드의 현재 로그 토큰 값은 변경되지 않습니다.
 
또한 다음 중 어느 것이라도 true인 경우 SetupWriteTextLog 는 로그 항목을 작성하지 않습니다. 로그 항목의 최대 길이(문자)는 336입니다.

텍스트 로그에서 SetupAPI 관련 오류 또는 Win32 오류에 대한 정보를 작성하려면 애플리케이션에서 SetupWriteTextLogError를 사용할 수 있습니다.

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

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

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

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

요구 사항

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

추가 정보

SetupGetThreadLogToken

SetupWriteTextLogError