Rückgabewerte (Windows-Barrierefreiheitsfeatures)

In diesem Thema werden die häufigsten Rückgabewerte und andere Rückgabewerte beschrieben, die möglicherweise seltener angezeigt werden.

Allgemeine Rückgabewerte

Die IAccessible-Methoden geben einen der folgenden Werte zurück, der in winerror.h definiert ist, oder einen anderen standardmäßigen COM-Fehlercode (Component Object Model):

Wert BESCHREIBUNG
S_OK Die Methode wurde erfolgreich ausgeführt.
S_FALSE Die Methode war teilweise erfolgreich. Dies geschieht, wenn die Methode erfolgreich ist, aber die angeforderten Informationen nicht verfügbar sind. Microsoft Active Accessibility gibt beispielsweise S_FALSE zurück, wenn Sie IAccessible::accHitTest aufrufen, um ein untergeordnetes Objekt an einem bestimmten Punkt abzurufen, und der angegebene Punkt befindet sich nicht innerhalb des Objekts oder des untergeordneten Objekts.
DISP_E_MEMBERNOTFOUND Das -Objekt unterstützt die angeforderte Eigenschaft oder Aktion nicht. Beispielsweise gibt eine Druckschaltfläche diesen Wert zurück, wenn Sie die Value-Eigenschaft anfordern, da sie keine Value-Eigenschaft aufweist.
E_NOTIMPL Die Methode ist nicht implementiert. Dieser Wert tritt auf, wenn ein Client eine Methode aufruft, die in diesem Betriebssystem noch nicht unterstützt wird.
E_INVALIDARG Mindestens ein Argument war ungültig. Dieser Fehler tritt auf, wenn der Aufrufer versucht, ein untergeordnetes Objekt mithilfe eines Bezeichners zu identifizieren, den der Server nicht erkennt. Dieser Fehler tritt auch auf, wenn ein Client versucht, ein untergeordnetes Objekt in einem Objekt zu identifizieren, das keine untergeordneten Elemente aufweist.
E_OUTOFMEMORY Die -Methode konnte keinen Arbeitsspeicher zuweisen, der für den Abschluss eines Vorgangs erforderlich ist, der für den Erfolg von entscheidender Bedeutung ist.
E_FAIL Ein unbekannter oder generischer Fehler ist aufgetreten.

 

Zusätzliche Rückgabewerte

Im Folgenden werden Rückgabewerte aufgeführt, die von IAccessible-Methoden zurückgegeben werden können. Diese Rückgabewerte sind nicht so häufig wie die vorherigen, aber Sie sollten sie kennen.

Wert BESCHREIBUNG
E_ACCESSDENIED Dies wird zurückgegeben, wenn Sie get_accValue aufrufen, um den Wert eines Kennwortsteuerelements abzurufen.
DISP_E_EXCEPTION
CO_E_OBJNOTCONNECTED