Metodo IMultiInterfaceEventControl::GetSubscriptions (eventsys.h)

Recupera la raccolta di oggetti di sottoscrizione associati a un metodo di evento.

Sintassi

HRESULT GetSubscriptions(
  [in]          REFIID                 eventIID,
  [in]          BSTR                   bstrMethodName,
  [in]          BSTR                   optionalCriteria,
  [in]          int                    *optionalErrorIndex,
  [out, retval] IEventObjectCollection **ppCollection
);

Parametri

[in] eventIID

Identificatore dell'interfaccia dell'interfaccia di attivazione.

[in] bstrMethodName

Metodo di evento associato alla raccolta di sottoscrizioni.

[in] optionalCriteria

Stringa che specifica i criteri di query. Se questo parametro è NULL, viene usata la query predefinita specificata dal metodo SetDefaultQuery . Per informazioni dettagliate sulla forma di un'espressione valida per questo parametro, vedere la sezione Osservazioni di seguito.

[in] optionalErrorIndex

Posizione, espressa come offset, di un errore nel parametro facoltativoCriteria . Questo parametro non può essere NULL.

[out, retval] ppCollection

Indirizzo di un puntatore a un'interfaccia IEventObjectCollection in un oggetto collection che enumera le sottoscrizioni associate all'oggetto evento.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL, nonché i valori seguenti.

Commenti

Questo metodo è una forma più specializzata del metodo IEventSystem::Query . Oltre a ottenere solo oggetti sottoscrizione, una raccolta ottenuta chiamando GetSubscriptions viene aggiornata automaticamente ogni volta che la raccolta di sottoscrizioni cambia.

I criteri di query specificati dal parametro facoltativoCriteria possono essere "ALL", per specificare una richiesta per tutti gli oggetti di sottoscrizione o un'espressione booleana che denota una o più condizioni che un oggetto sottoscrizione deve soddisfare per essere incluso nel risultato della query. Le espressioni valide sono del modulo seguente:

[NOT] valorepropertynamerelationalOperator. Gli operatori relazionali validi sono i seguenti:

==, =, !=, <>, ~=. I valori validi sono "string", 'string', {GUID}, TRUE, FALSE, NULL.

Le singole espressioni booleane possono essere unite a AND o OR. Le espressioni possono essere annidate tra parentesi per applicare un ordine specifico di valutazione.

Di seguito sono riportati alcuni esempi di criteri di query validi:

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

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

Requisiti

Vedi anche

IMultiInterfaceEventControl