다음 예제에서는 애플리케이션이 일반적으로 SetupWriteTextLog 호출하여 경고 메시지 또는 오류 메시지가 아닌 SetupAPI 텍스트 로그 정보 항목을 작성하는 방법을 보여 드립니다.
오류 메시지를 기록하기 위해 SetupWriteTextLog 호출하는 방법에 대한 자세한 내용은 SetupWriteTextLog를 호출하여 오류 또는 경고 항목기록합니다.
애플리케이션은 SetupWriteTextLog호출하여 다음 매개 변수 값을 제공합니다.
LogToken은 SetupGetThreadLogToken을 호출하여 얻은 로그 토큰 값으로 설정되거나 로그 토큰에 설명된 시스템 정의 로그 토큰 값들 중 하나입니다.
범주 TXTLOG_VENDOR 설정됩니다. 이는 공급업체에서 제공하는 애플리케이션에서 로그 항목이 생성되었음을 나타냅니다. 이벤트 범주는 텍스트 로그에서 이벤트 범주를 활성화하기 위해 설명되어 있습니다.
플래그은 TXTLOG_DETAILS 및 TXTLOG_TIMESTAMP를 비트별 OR 연산으로 설정합니다. 이 예제에서는 들여쓰기 깊이가 변경되지 않고 현재 들여쓰기 깊이가 이전에 5개의 모노스페이스 텍스트 공간으로 설정되었습니다. 들여쓰기 깊이를 변경하는 방법에 대한 자세한 내용은 들여쓰기 로그 항목 작성 을 확인하세요. 이벤트 수준은 텍스트 로그 항목에 대한 이벤트 수준 설정에 설명되어 있습니다.
MessageStr TEXT("관심 변수: = %d")로 설정됩니다.
쉼표로 구분된 매개 변수 목록은 MessageStr"%d" 필드에 해당하는 SomeVariable 변수를 제공합니다.
//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR;
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1; // The variable whose value will be logged
SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);
TXTLOG_VENDOR 이벤트 범주를 사용하도록 설정하고 디바이스 설치 텍스트 로그에 대해 TXTLOG_DETAILS 이벤트 수준을 설정하는 경우 이 코드는 다음 형식으로 디바이스 설치 로그에 항목을 만듭니다. 여기서 타임스탬프는 실제 타임스탬프를 대체합니다.
2005/02/13 22:06:28.109: : Variable of interest: Abc = 1