Valori restituiti (funzionalità di accessibilità di Windows)

In questo argomento vengono descritti i valori restituiti più comuni e altri valori restituiti che potrebbero essere visualizzati meno frequentemente.

Valori restituiti comuni

I metodi IAccessi restituiscono uno dei valori seguenti, definiti in winerror.h o un altro codice di errore com (Component Object Model) standard:

Valore	Descrizione
S_OK	Il metodo è riuscito.
S_FALSE	Il metodo ha avuto esito positivo in parte. Ciò accade quando il metodo ha esito positivo, ma le informazioni richieste non sono disponibili. Ad esempio, Microsoft Active Accessibility restituisce S_FALSE se si chiama IAccess::accHitTest per recuperare un oggetto figlio in un determinato punto e il punto specificato non si trova all'interno dell'oggetto o del figlio dell'oggetto.
DISP_E_MEMBERNOTFOUND	L'oggetto non supporta la proprietà o l'azione richiesta. Ad esempio, un pulsante push restituisce questo valore se si richiede la relativa proprietà Value, perché non ha una proprietà Value.
E_NOTIMPL	Il metodo non è implementato. Questo valore si verifica quando un client chiama un metodo che non è ancora supportato nel sistema operativo.
E_INVALIDARG	Uno o più argomenti non sono validi. Questo errore si verifica quando il chiamante tenta di identificare un oggetto figlio usando un identificatore che il server non riconosce. Questo errore genera anche quando un client tenta di identificare un oggetto figlio all'interno di un oggetto che non ha elementi figlio.
E_OUTOFMEMORY	Il metodo non è riuscito a allocare memoria necessaria per completare un'operazione fondamentale per il suo successo.
E_FAIL	Si è verificato un errore sconosciuto o generico.

 

Valori restituiti aggiuntivi

Di seguito sono riportati i valori restituiti dai metodi IAccessibile . Questi valori restituiti non sono comuni come quelli precedenti, ma si dovrebbe essere consapevoli di loro.

Valore	Descrizione
E_ACCESSDENIED	Viene restituito quando si chiama get_accValue per ottenere il valore di un controllo password.
DISP_E_EXCEPTION
CO_E_OBJNOTCONNECTED