EvtGetObjectArrayProperty 함수(winevt.h)

배열의 지정된 개체에서 공급자 메타데이터 속성을 가져옵니다.

구문

BOOL EvtGetObjectArrayProperty(
  [in]  EVT_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in]  DWORD                            PropertyId,
  [in]  DWORD                            ArrayIndex,
  [in]  DWORD                            Flags,
  [in]  DWORD                            PropertyValueBufferSize,
  [in]  PEVT_VARIANT                     PropertyValueBuffer,
  [out] PDWORD                           PropertyValueBufferUsed
);

매개 변수

[in] ObjectArray

EvtGetPublisherMetadataProperty 함수가 반환하는 개체 배열에 대한 핸들입니다.

[in] PropertyId

지정된 개체에서 가져올 메타데이터 속성의 속성 식별자입니다. 가능한 값은 EVT_PUBLISHER_METADATA_PROPERTY_ID 설명 섹션을 참조하세요.

[in] ArrayIndex

배열에 있는 개체의 인덱스(0부터 시작)입니다.

[in] Flags

예약되어 있습니다. 0이어야 합니다.

[in] PropertyValueBufferSize

PropertyValueBuffer 버퍼의 크기(바이트)입니다.

[in] PropertyValueBuffer

메타데이터 속성을 받을 호출자가 할당한 버퍼입니다. 버퍼에는 EVT_VARIANT 개체가 포함됩니다. 이 매개 변수를 NULL 로 설정하여 필요한 버퍼 크기를 확인할 수 있습니다.

[out] PropertyValueBufferUsed

함수가 사용한 호출자 할당 버퍼의 크기(바이트)이거나 함수가 ERROR_INSUFFICIENT_BUFFER 실패하는 경우 필요한 버퍼 크기입니다.

반환 값

반환 코드/값	설명
TRUE	함수가 성공했습니다.
FALSE	함수가 실패했습니다. 오류 코드를 얻으려면 GetLastError 함수를 호출합니다.

설명

다음 ID를 사용하여 EvtGetPublisherMetadataProperty 함수를 호출하면 함수는 해당 형식의 개체 배열에 대한 핸들을 반환합니다.

• EvtPublisherMetadataChannelReferences
• EvtPublisherMetadataLevels
• EvtPublisherMetadataTasks
• EvtPublisherMetadataOpcodes
• EvtPublisherMetadataKeywords

예를 들어 EvtPublisherMetadataKeywords를 EvtGetPublisherMetadataProperty에 전달하는 경우 함수는 키워드(keyword) 개체의 배열에 대한 핸들을 반환합니다.

배열의 크기를 확인하려면 EvtGetObjectArraySize 함수를 호출합니다.

예제

이 함수를 사용하는 방법을 보여 주는 예제는 공급자의 메타데이터 가져오기를 참조하세요.

요구 사항

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

추가 정보

EVT_PUBLISHER_METADATA_PROPERTY_ID

EvtGetPublisherMetadataProperty