다음을 통해 공유


LogFileEventConsumer 클래스

LogFileEventConsumer 클래스는 이벤트가 전달될 때 사용자 지정 문자열을 텍스트 로그 파일에 씁니다. 문자열은 줄의 끝 시퀀스로 구분됩니다. 이 클래스는 WMI에서 제공하는 표준 이벤트 소비자 중 하나입니다. 자세한 내용은 표준 소비자를 사용하여 이벤트 모니터링 및 응답을 참조하세요.

구문

[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
  uint8   CreatorSID[];
  string  MachineName;
  uint32  MaximumQueueSize;
  string  Filename;
  boolean IsUnicode;
  uint64  MaximumFileSize = 65535;
  string  Name;
  string  Text;
};

멤버

LogFileEventConsumer 클래스에는 다음 형식의 멤버가 있습니다.

속성

LogFileEventConsumer 클래스에는 이러한 속성이 있습니다.

CreatorSID

데이터 형식: uint8 배열

액세스 형식: 읽기 전용

필터를 만드는 사용자를 고유하게 식별하는 SID(보안 식별자)입니다. WMI는 운영 체제에 따라 __EventConsumer의 인스턴스 또는 관리자 SID를 만드는 사용자의 SID를 저장합니다. 자세한 내용은 논리적 소비자를 사용하여 이벤트 필터 바인딩표준 소비자를 사용하여 이벤트 모니터링 및 응답을 참조하세요.

이 속성은 __EventConsumer에서 상속됩니다.

Filename

데이터 형식: 문자열

액세스 형식: 읽기 전용

로그 항목이 추가되는 경로를 포함하는 파일의 이름입니다. 파일이 없으면 LogFileEventConsumer가 만들려고 시도합니다. 경로가 없거나 소비자를 만드는 사용자에게 파일 또는 경로에 대한 쓰기 권한이 없는 경우 소비자가 실패합니다.

IsUnicode

데이터 형식: boolean

액세스 형식: 읽기 전용

TRUE면 로그 파일은 유니코드 텍스트 파일입니다. FALSE면 로그 파일은 멀티바이트 코드 텍스트 파일입니다. 파일이 있는 경우 이 속성은 무시되고 현재 파일 설정이 사용됩니다. 예를 들어 IsUnicodeFALSE지만 기존 파일이 유니코드 파일인 경우 유니코드가 사용됩니다. IsUnicodeTRUE지만 파일이 멀티바이트 코드인 경우 멀티바이트 코드가 사용됩니다.

MachineName

데이터 형식: 문자열

액세스 형식: 읽기 전용

WMI(Windows Management Instrumentation)에서 보낸 이벤트를 수신하는 컴퓨터의 이름입니다.

이 속성은 __EventConsumer에서 상속됩니다.

MaximumFileSize

데이터 형식: uint64

액세스 형식: 읽기 전용

로그 파일의 최대 크기(바이트). 기본 파일이 최대 크기를 초과하면 콘텐츠가 다른 파일로 이동되고 기본 파일이 비워집니다. 0(영)값은 크기 제한이 없다는 의미입니다. 기본값은 65,535바이트입니다. 파일의 크기는 쓰기 작업 전에 확인됩니다. 따라서 지정된 크기 제한보다 약간 큰 파일을 가질 수 있습니다. 다음 쓰기 작업은 이를 가져오고 새 파일을 시작합니다.

다음 목록에서는 백업 파일의 명명 구조를 식별합니다.

  • 원래 파일 이름이 8.3인 경우 확장명은 "001", "002"... 형식의 문자열로 바뀌며 이전에 사용된 숫자와 선택한 숫자보다 가장 작은 숫자가 더 큽니다. "999"를 사용하는 경우 선택한 숫자는 사용되지 않는 가장 작은 숫자입니다.
  • 원래 파일 이름이 8.3이 아니면 "001", "002"... 형식의 문자열이 파일 이름에 추가됩니다.

스크립트에서 uint64 값을 사용하는 방법에 관한 자세한 내용은 WMI 스크립트 만들기를 참조하세요.

MaximumQueueSize

데이터 형식: uint32

액세스 형식: 읽기 전용

특정 소비자의 최대 큐(바이트)입니다.

이 속성은 __EventConsumer에서 상속됩니다.

이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자:

이 소비자의 고유한 이름입니다.

Text

데이터 형식: 문자열

액세스 형식: 읽기 전용

로그 항목의 텍스트에 대한 표준 문자열 템플릿입니다.

설명

참고

LogFileEventConsumer는 로그 파일을 보호하지 않습니다. 따라서 LogFileEventConsumer를 구성할 때 필요한 수준으로 보호되는 디렉터리를 지정하는 것이 중요합니다.

LogFileEventConsumer 클래스는 __EventConsumer 추상 클래스에서 파생됩니다.

예제

LogFileEventConsumer를 사용하여 소비자를 만드는 예제는 이벤트를 기반으로 로그 파일에 쓰기를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows Vista
지원되는 최소 서버
Windows Server 2008
네임스페이스
Root\subscription
MOF
Wbemcons.mof
DLL
Wbemcons.dll

추가 정보

표준 소비자 클래스

이벤트를 기반으로 로그 파일에 쓰기

논리적 소비자 만들기

항상 이벤트 수신

__EventConsumer