Metodo IEventSystem::RemoveS (eventsys.h)
Rimuove una o più sottoscrizioni o oggetti evento dall'archivio dati dell'evento.
Sintassi
HRESULT RemoveS(
[in] BSTR progID,
[in] BSTR queryCriteria
);
Parametri
[in] progID
ProgID della classe oggetto da rimuovere. Questo deve essere un identificatore di classe dell'oggetto evento valido. Questo parametro può essere uno dei valori seguenti:
- PROGID_EventClass
- PROGID_EventClassCollection
- PROGID_EventSubscription
- PROGID_EventSubscriptionCollection
[in] queryCriteria
Criteri di query. Per informazioni dettagliate sulla forma di un'espressione valida per questo parametro, vedere la sezione Osservazioni di seguito.
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 |
---|---|
|
Metodo completato correttamente. |
|
Si è verificato un errore di sintassi durante il tentativo di valutare una stringa di query. |
|
Un nome di campo non valido è stato usato in una stringa di query. |
|
Non tutti gli oggetti richiesti potrebbero essere rimossi. |
Commenti
I criteri di query specificati dal parametro queryCriteria possono essere "ALL", per specificare una richiesta per tutti gli oggetti 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-0080C7D771BF}"
"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'"
Requisiti
Requisito | Valore |
---|---|
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 |