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 |