PROPERTY_DATA_DESCRIPTOR 구조체(tdh.h)

  • 아티클

검색할 속성을 정의합니다.

구문

typedef struct _PROPERTY_DATA_DESCRIPTOR {
  ULONGLONG PropertyName;
  ULONG     ArrayIndex;
  ULONG     Reserved;
} PROPERTY_DATA_DESCRIPTOR;

멤버

PropertyName

대/소문자를 구분하는 속성 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. EVENT_PROPERTY_INFO 구조체의 NameOffset 멤버를 사용하여 속성 이름을 가져올 수 있습니다.

다음 표에서는 WPP 이벤트에 대한 PropertyName 의 가능한 값을 나열합니다. TdhGetProperty에서 반환된 버퍼의 서식을 지정할 때 제안된 TDH 데이터 형식을 사용합니다.

Name TDH 데이터 형식 Description
FormattedString TDH_INTYPE_UNICODESTRING 형식이 지정된 WPP 추적 메시지입니다.
SequenceNum TDH_INTYPE_UINT32 추적 메시지의 로컬 또는 전역 시퀀스 번호입니다. 이 추적 세션에만 고유한 로컬 시퀀스 번호가 기본값입니다.
FunctionName TDH_INTYPE_UNICODESTRING 추적 메시지를 생성한 함수의 이름입니다.
ComponentName TDH_INTYPE_UNICODESTRING 추적 메시지를 생성한 공급자의 구성 요소 이름입니다. 구성 요소 이름은 추적 코드에 지정된 경우에만 표시됩니다.
SubComponentName TDH_INTYPE_UNICODESTRING 추적 메시지를 생성한 공급자의 하위 구성 요소 이름입니다. 하위 구성 요소 이름은 추적 코드에 지정된 경우에만 표시됩니다.
TraceGuid TDH_INTYPE_GUID WPP 추적 메시지와 연결된 GUID입니다.
GuidTypeName TDH_INTYPE_UNICODESTRING WPP 추적 메시지가 추적된 소스 코드의 줄 번호와 연결된 파일 이름입니다.
SystemTime TDH_INTYPE_SYSTEMTIME WPP 추적 메시지가 생성된 시간입니다.
FlagsName TDH_INTYPE_UNICODESTRING 추적 메시지를 사용하도록 설정하는 추적 플래그의 이름입니다.
LevelName TDH_INTYPE_UNICODESTRING 추적 메시지를 사용하도록 설정하는 추적 수준의 값입니다.

ArrayIndex

속성 배열의 요소에 액세스하기 위한 인덱스(0부터 시작)입니다. 속성 데이터가 배열이 아니거나 전체 배열의 주소를 지정하려면 ULONG_MAX(0xFFFFFFFF)을 지정합니다.

Reserved

예약되어 있습니다.

설명

구조체를 설명하려면 PropertyName을 구조체의 이름으로 설정하고 ArrayIndex를 ULONG_MAX.

구조체의 멤버를 설명하려면 두 PROPERTY_DATA_DESCRIPTOR 구조체의 배열을 정의합니다. 첫 번째 설명자에서 PropertyName을 구조체의 이름으로 설정하고 ArrayIndex를 0으로 설정합니다. 두 번째 설명자에서 PropertyName을 멤버 이름으로 설정하고 ArrayIndex를 ULONG_MAX.

구조체가 구조체 배열의 요소인 경우 첫 번째 설명자의 ArrayIndex를 배열에 있는 구조체의 0부터 시작하는 인덱스로 설정합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 tdh.h

추가 정보

TdhGetProperty

TdhGetPropertySize