Metodo IMultiInterfaceEventControl::SetDefaultQuery (eventsys.h)

  • Articolo

Stabilisce una query predefinita da utilizzare quando un filtro del server di pubblicazione non è associato a un metodo di evento.

Sintassi

HRESULT SetDefaultQuery(
  [in]          REFIID eventIID,
  [in]          BSTR   bstrMethodName,
  [in]          BSTR   bstrCriteria,
  [out, retval] int    *errorIndex
);

Parametri

[in] eventIID

Identificatore di interfaccia dell'interfaccia di attivazione.

[in] bstrMethodName

Nome del metodo a cui è assegnata la query predefinita.

[in] bstrCriteria

Stringa che specifica i criteri di query. Questo parametro non può essere NULL. Per informazioni dettagliate sulla creazione di un'espressione valida per questo parametro, vedere la sezione Osservazioni di seguito.

[out, retval] errorIndex

Posizione, espressa come offset, di un errore nel parametro bstrCriteria .

Valore restituito

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

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.
EVENT_E_QUERYSYNTAX
 Si è verificato un errore di sintassi durante il tentativo di valutare una stringa di query.
EVENT_E_QUERYFIELD
 In una stringa di query è stato usato un nome di campo non valido.
EVENT_E_INTERNALEXCEPTION
 È stata generata un'eccezione imprevista.
EVENT_E_INTERNALERROR
 È stato rilevato un errore interno imprevisto.

Commenti

Questo metodo è una forma più specializzata del metodo IEventSystem::Query . Oltre a ottenere solo gli 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 bstrCriteria possono essere "ALL", per specificare una richiesta per tutti gli oggetti sottoscrizione o un'espressione booleana che indica una o più condizioni che un oggetto sottoscrizione deve soddisfare per essere incluso nel risultato della query. Le espressioni valide sono del formato seguente:

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

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

È possibile unire singole espressioni booleane con 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-0080C7D771BF}"

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

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione eventsys.h

Vedi anche

IMultiInterfaceEventControl