Returvärden (Hjälpmedelsfunktioner i Windows)

Det här avsnittet beskriver de vanligaste returvärdena och andra returvärden som du kanske ser mindre ofta.

Vanliga returvärden

Metoderna IAccessible returnerar något av följande värden, som definierats i winerror.h, eller någon annan com-felkod (Component Object Model):

Värde	Beskrivning
S_OK	Metoden lyckades.
S_FALSE	Metoden lyckades delvis. Detta inträffar när metoden lyckas, men den begärda informationen är inte tillgänglig. Microsoft Active Accessibility returnerar till exempel S_FALSE om du anropar IAccessible::accHitTest för att hämta ett underordnat objekt vid en viss punkt och den angivna punkten inte finns inom objektet eller objektets underordnade.
DISP_E_MEMBERNOTFOUND	Objektet stöder inte den begärda egenskapen eller åtgärden. En push-knapp returnerar till exempel det här värdet om du begär dess egenskap Valueeftersom den inte har någon värdeegenskap.
E_NOTIMPL	Metoden har inte implementerats. Det här värdet inträffar när en klient anropar en metod som ännu inte stöds i operativsystemet.
E_INVALIDARG	Ett eller flera argument var ogiltiga. Det här felet uppstår när anroparen försöker identifiera ett underordnat objekt med hjälp av en identifierare som servern inte känner igen. Det här felet uppstår också när en klient försöker identifiera ett underordnat objekt i ett objekt som inte har några underordnade objekt.
E_OUTOFMEMORY	Metoden kunde inte allokera minne som krävs för att slutföra en åtgärd som är avgörande för dess framgång.
E_FAIL	Ett okänt eller allmänt fel uppstod.

 

Ytterligare returvärden

Följande är returvärden som IAccessible metoder kan returnera. Dessa returvärden är inte lika vanliga som de tidigare, men du bör vara medveten om dem.

Värde	Beskrivning
E_ACCESSDENIED	Detta returneras när du anropar get_accValue för att hämta värdet för en lösenordskontroll.
DISP_E_EXCEPTION
CO_E_OBJNOTCONNECTED