Návratové hodnoty (funkce přístupnosti systému Windows)

Toto téma popisuje nejběžnější návratové hodnoty a další vrácené hodnoty, které se můžou zobrazovat méně často.

Běžné návratové hodnoty

Metody IAccessible vrací jednu z následujících hodnot definovaných v souboru winerror.h nebo jiný kód chyby modelu COM (Component Object Model):

Hodnota	Popis
S_OK	Metoda byla úspěšná.
S_FALSE	Metoda byla částečně úspěšná. K tomu dochází v případě, že metoda proběhne úspěšně, ale požadované informace nejsou k dispozici. Microsoft Active Accessibility například vrátí S_FALSE pokud zavoláte IAccessible::accHitTest načtení podřízeného objektu v daném bodě a zadaný bod není uvnitř objektu nebo podřízeného objektu.
DISP_E_MEMBERNOTFOUND	Objekt nepodporuje požadovanou vlastnost ani akci. Například tlačítko push vrátí tuto hodnotu, pokud požadujete jeho Value vlastnost, protože nemá value vlastnost.
E_NOTIMPL	Metoda není implementována. K této hodnotě dochází, když klient volá metodu, která ještě není v tomto operačním systému podporována.
E_INVALIDARG	Jeden nebo více argumentů nebylo platné. K této chybě dochází, když se volající pokusí identifikovat podřízený objekt pomocí identifikátoru, který server nerozpozná. Tato chyba také vede k tomu, že se klient pokusí identifikovat podřízený objekt v objektu, který nemá žádné podřízené položky.
E_OUTOFMEMORY	Metoda nemohla přidělit paměť potřebnou k dokončení operace, která je nezbytná pro její úspěch.
E_FAIL	Došlo k neznámé nebo obecné chybě.

 

Další vrácené hodnoty

Níže jsou uvedené návratové hodnoty, které IAccessible metody mohou vrátit. Tyto návratové hodnoty nejsou tak běžné jako předchozí hodnoty, ale měli byste o nich vědět.

Hodnota	Popis
E_ACCESSDENIED	Vrátí se při volání get_accValue získat hodnotu ovládacího prvku hesla.
DISP_E_EXCEPTION
CO_E_OBJNOTCONNECTED