EcGetSubscriptionRunTimeStatus 함수(evcoll.h)

EcGetSubscriptionRunTimeStatus 함수는 구독 또는 구독 자체의 이벤트 원본에 대한 런타임 상태 정보를 검색합니다. 구독은 해당 이름으로 지정됩니다. 이벤트 원본이 NULL이면 전체 구독에 대한 상태 검색됩니다.

구문

BOOL EcGetSubscriptionRunTimeStatus(
  [in]  LPCWSTR                                SubscriptionName,
  [in]  EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID StatusInfoId,
  [in]  LPCWSTR                                EventSourceName,
  [in]  DWORD                                  Flags,
  [in]  DWORD                                  StatusValueBufferSize,
  [in]  PEC_VARIANT                            StatusValueBuffer,
  [out] PDWORD                                 StatusValueBufferUsed
);

매개 변수

[in] SubscriptionName

런타임 상태 정보를 가져올 구독의 이름입니다.

[in] StatusInfoId

구독에서 가져올 정보를 상태 런타임을 지정하는 식별자입니다. EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID 열거형에서 값을 지정합니다. EcSubscriptionRunTimeStatusEventSources 값을 사용하여 구독과 연결된 이벤트 원본 목록을 가져올 수 있습니다.

[in] EventSourceName

상태 가져올 이벤트 원본의 이름입니다. 각 구독에는 여러 이벤트 원본이 있을 수 있습니다.

[in] Flags

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

[in] StatusValueBufferSize

런타임 상태 정보를 보유할 사용자 제공 버퍼의 크기입니다.

[in] StatusValueBuffer

런타임 상태 정보를 보유할 사용자가 제공한 버퍼입니다. 버퍼는 StatusInfoId 매개 변수에 전달된 EC_SUBSCRIPTION_RUNTIME_STATUS_INFO_ID 값에 따라 적절한 값을 보유합니다.

[out] StatusValueBufferUsed

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

반환 값

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

요구 사항

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

추가 정보

Windows 이벤트 수집기 함수