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, UserName 및 Password 속성을 가져옵니다.

[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, UserName 및 Password 속성이 있을 수 있습니다.

예제

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

요구 사항

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

추가 정보

Windows 이벤트 수집기 함수