TdhGetPropertySize 함수(tdh.h)

  • 아티클

이벤트 데이터에서 하나 이상의 속성 값의 크기를 검색합니다.

구문

TDHSTATUS TdhGetPropertySize(
  [in]  PEVENT_RECORD             pEvent,
  [in]  ULONG                     TdhContextCount,
  [in]  PTDH_CONTEXT              pTdhContext,
  [in]  ULONG                     PropertyDataCount,
  [in]  PPROPERTY_DATA_DESCRIPTOR pPropertyData,
  [out] ULONG                     *pPropertySize
);

매개 변수

[in] pEvent

EventRecordCallback 콜백에 전달된 이벤트 레코드입니다. 자세한 내용은 EVENT_RECORD 구조를 참조하세요.

[in] TdhContextCount

pTdhContext의 요소 수입니다.

[in] pTdhContext

WPP 또는 클래식 ETW 이벤트에 대한 컨텍스트 값의 배열이며, 그렇지 않으면 NULL입니다. 자세한 내용은 TDH_CONTEXT 구조를 참조하세요. 배열에 중복 컨텍스트 형식이 포함되어서는 안됩니다.

[in] PropertyDataCount

pPropertyData의 데이터 설명자 구조 수입니다.

[in] pPropertyData

검색할 크기의 속성을 정의하는 PROPERTY_DATA_DESCRIPTOR 구조체의 배열입니다.

이 동일한 배열을 TdhGetProperty 함수에 전달하여 속성 데이터를 검색할 수 있습니다.

구조체의 멤버가 아닌 속성의 크기를 검색하는 경우 단일 데이터 설명자를 지정할 수 있습니다. 구조체의 멤버인 속성의 크기를 검색하는 경우 두 데이터 설명자의 배열을 지정합니다(구조체는 다른 구조를 포함하거나 참조할 수 없음). 이 매개 변수를 지정하는 방법에 대한 자세한 내용은 아래 예제 코드를 참조하세요.

[out] pPropertySize

속성의 크기(바이트)입니다. 이 값을 사용하여 TdhGetProperty 함수의 pBuffer 매개 변수에 전달된 버퍼를 할당합니다.

반환 값

성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 이 함수는 다른 코드 외에도 다음 반환 코드 중 하나를 반환합니다.

반환 코드 설명
ERROR_NOT_FOUND
 이벤트에 대한 스키마를 찾을 수 없거나 지정된 맵을 찾을 수 없습니다.

MOF 클래스를 사용하여 이벤트를 정의한 경우 TDH는 WMI 리포지토리에서 스키마를 찾습니다. 매니페스트를 사용하여 이벤트를 정의한 경우 TDH는 공급자의 리소스를 찾습니다. 매니페스트를 사용하는 경우 공급자 요소의 resourceFileName 특성은 TDH가 리소스를 찾을 것으로 예상되는 위치를 정의합니다.
ERROR_INVALID_PARAMETER
 하나 이상의 매개 변수가 잘못되었습니다.
ERROR_FILE_NOT_FOUND
 매니페스트의 resourceFileName 특성에는 공급자 이진 파일의 위치가 포함됩니다. 매니페스트를 등록하면 위치가 레지스트리에 기록됩니다. TDH가 등록된 위치에 따라 이진 파일을 찾을 수 없습니다.
ERROR_WMI_SERVER_UNAVAILABLE
 WMI 서비스를 사용할 수 없습니다.

설명

이벤트가 WPP 또는 클래식 ETW 이벤트인 경우 이벤트 정보를 구문 분석하는 데 사용되는 컨텍스트 정보를 지정할 수 있습니다. EVENT_HEADER_FLAG_TRACE_MESSAGE 플래그가 EVENT_HEADER Flags 멤버에 설정된 경우 이 이벤트는 WPP 이벤트입니다(EVENT_RECORDEventHeader 멤버 참조). EVENT_HEADER_FLAG_CLASSIC_HEADER 플래그가 설정된 경우 이벤트는 레거시 ETW 이벤트입니다.

예제

이 함수를 호출하는 방법을 보여 주는 예제는 TdhGetProperty를 사용하여 이벤트 데이터 사용을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tdh.h
라이브러리 Tdh.lib
DLL Tdh.dll

추가 정보

TdhGetProperty