다음을 통해 공유


EcGetObjectArrayProperty 함수(evcoll.h)

EcGetObjectArrayProperty 함수는 핸들에서 이벤트 원본 속성 배열로 속성 값을 검색합니다. 배열에는 구독의 이벤트 원본에 대한 속성 값이 포함됩니다.

구문

BOOL EcGetObjectArrayProperty(
  [in]  EC_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in]  EC_SUBSCRIPTION_PROPERTY_ID     PropertyId,
  [in]  DWORD                           ArrayIndex,
  [in]  DWORD                           Flags,
  [in]  DWORD                           PropertyValueBufferSize,
  [in]  PEC_VARIANT                     PropertyValueBuffer,
  [out] PDWORD                          PropertyValueBufferUsed
);

매개 변수

[in] ObjectArray

구독에 대한 이벤트 원본의 속성 배열에 대한 핸들입니다. EcSubscriptionEventSources 값이 PropertyId 매개 변수에 전달될 때 EcGetSubscriptionProperty 메서드에서 반환되는 배열 핸들입니다.

[in] PropertyId

배열의 속성에 대한 속성 식별자입니다. EC_SUBSCRIPTION_PROPERTY_ID 열거형의 값을 지정합니다. EcSubscriptionEventSourceAddress, EcSubscriptionEventSourceEnabled, EcSubscriptionEventSourceUserName 또는 EcSubscriptionEventSourcePassword 값을 지정하여 배열에서 Address, Enabled, UserNamePassword 속성을 가져옵니다.

[in] ArrayIndex

속성을 가져올 이벤트 원본을 지정하는 배열의 인덱스입니다.

[in] Flags

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

[in] PropertyValueBufferSize

속성의 값을 포함하는 버퍼의 크기입니다. 크기는 EC_VARIANT 값의 크기 이상이어야 합니다.

[in] PropertyValueBuffer

속성 값을 저장할 사용자가 제공한 버퍼입니다.

[out] PropertyValueBufferUsed

성공적으로 반환할 때 함수에서 사용하는 사용자 제공 버퍼의 크기 또는 함수가 ERROR_INSUFFICIENT_BUFFER 함께 실패할 때 속성 값을 저장하는 데 필요한 크기입니다.

반환 값

이 함수는 BOOL을 반환합니다.

설명

배열은 0부터 시작하므로 배열의 첫 번째 항목에 대한 인덱스는 0입니다.

이벤트 원본 또는 구독에 대한 Password 속성을 검색할 수 없습니다. 보안상의 이유로 속성 값에 대해 빈 문자열이 반환되고 마지막 오류가 ERROR_ACCESS_DENIED 설정됩니다.

구독에는 여러 이벤트 원본이 있을 수 있으며 각 원본에는 Address, Enabled, UserNamePassword 속성이 있을 수 있습니다.

예제

EcGetObjectArrayProperty 함수를 사용하는 예제 코드는 이벤트 수집기 구독의 속성 표시를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 evcoll.h
라이브러리 Wecapi.lib
DLL Wecapi.dll

추가 정보

Windows 이벤트 수집기 함수