Condividi tramite

Valori restituiti (funzionalità di accessibilità di Windows)

  • Articolo

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