Metodo IRawElementProviderAdviseEvents::AdviseEventRemoved (uiautomationcore.h)

Notifica al provider di Automazione interfaccia utente Microsoft quando un client Automazione interfaccia utente smette di ascoltare un evento specifico, incluso un evento di modifica della proprietà.

Sintassi

HRESULT AdviseEventRemoved(
  [in] EVENTID   eventId,
  [in] SAFEARRAY *propertyIDs
);

Parametri

[in] eventId

Tipo: EVENTID

Identificatore dell'evento da rimuovere. Per un elenco degli ID evento, vedere Identificatori di evento.

[in] propertyIDs

Tipo: SAFEARRAY*

Puntatore agli identificatori delle proprietà da rimuovere o NULL se il listener di eventi da rimuovere non è in ascolto degli eventi di proprietà.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo consente al provider di ridurre il sovraccarico generando solo eventi in ascolto.

È importante che Automazione interfaccia utente provider trattino IRawElementProviderAdviseEvents::AdviseEventRemoved come il metodo Release dell'interfaccia IUnknown. Finché AdviseEventAdded è stato chiamato più volte rispetto a AdviseEventRemoved per un evento o una proprietà specifica, il provider deve continuare a generare eventi corrispondenti, perché alcuni client sono ancora in ascolto. In alternativa, Automazione interfaccia utente provider possono usare la funzione UiaClientsAreListening per determinare se almeno un client è in ascolto e, in tal caso, generare tutti gli eventi appropriati.

Requisiti

Vedi anche

Procedure consigliate per l'uso di matrici sicure

Informazioni concettuali

IRawElementProviderAdviseEvents

Riferimento