IEventSystem::QueryS 메서드(eventsys.h)

이벤트 데이터 저장소에서 구독 또는 이벤트 개체의 컬렉션을 검색합니다.

구문

HRESULT QueryS(
  [in]          BSTR     progID,
  [in]          BSTR     queryCriteria,
  [out, retval] IUnknown **ppInterface
);

매개 변수

[in] progID

쿼리할 개체 클래스의 ProgID입니다. 유효한 이벤트 개체 클래스 식별자여야 합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

• PROGID_EventClass
• PROGID_EventClassCollection
• PROGID_EventSubscription
• PROGID_EventSubscriptionCollection

[in] queryCriteria

쿼리 조건입니다. 이 매개 변수에 대한 유효한 식을 형성하는 자세한 내용은 아래 설명 섹션을 참조하세요.

[out, retval] ppInterface

쿼리 결과로 가져온 개체에 대한 포인터의 주소입니다. 이 매개 변수는 NULL일 수 없습니다. progID 매개 변수로 지정된 개체에 따라 다음 인터페이스 중 하나에 대한 포인터입니다.

• IEventClass
• IEventObjectCollection
• IEventSubscription

반환 값

이 메서드는 다음 값뿐만 아니라 표준 반환 값 E_INVALIDARG, E_POINTER, E_OUTOFMEMORY, E_UNEXPECTED 및 E_FAIL 반환할 수 있습니다.

설명

호출자는 ppInterface 매개 변수를 통해 할당된 메모리를 해제합니다.

queryCriteria 매개 변수로 지정된 쿼리 조건은 "ALL"이 될 수 있으며, 모든 구독 개체에 대한 요청을 지정하거나 쿼리 결과에 포함하기 위해 구독 개체가 충족해야 하는 하나 이상의 조건을 나타내는 부울 식일 수 있습니다. 유효한 식은 다음과 같은 형식입니다.

[NOT] propertynamerelationalOperator값입니다. 유효한 관계형 연산자는 다음과 같습니다.

==, =, !=, <>, ~=. 유효한 값은 "string", 'string', {GUID}, TRUE, FALSE, NULL입니다.

개별 부울 식을 AND 또는 OR과 조인할 수 있습니다. 식은 괄호 안에 중첩되어 특정 평가 순서를 적용할 수 있습니다.

다음은 유효한 쿼리 조건의 몇 가지 예입니다.

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF}"

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'"

요구 사항

추가 정보

IEventSystem