Freigeben über


IAccessible::get_accChild-Methode (oleacc.h)

Die IAccessible::get_accChild-Methode ruft einen IDispatch für das angegebene untergeordnete Element ab, sofern vorhanden. Alle Objekte müssen diese Eigenschaft unterstützen.

Syntax

HRESULT get_accChild(
  [in]          VARIANT   varChild,
  [out, retval] IDispatch **ppdispChild
);

Parameter

[in] varChild

Typ: VARIANT

Gibt das untergeordnete Element an, dessen IDispatch-Schnittstelle abgerufen wird. Weitere Informationen zum Initialisieren von VARIANT finden Sie unter Verwenden untergeordneter IDs in Parametern.

[out, retval] ppdispChild

Typ: IDispatch**

[out, retval] Empfängt die Adresse der IDispatch-Schnittstelle des untergeordneten Objekts.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, gibt einen der Werte in der folgenden Tabelle oder einen anderen COM-Standardfehlercode zurück. Server geben diese Werte zurück, aber Clients müssen ausgabeparameter immer überprüfen, um sicherzustellen, dass sie gültige Werte enthalten. Weitere Informationen finden Sie unter Überprüfen von IAccessible-Rückgabewerten.

Fehler BESCHREIBUNG
S_FALSE
Das untergeordnete Objekt ist kein zugängliches Objekt.
E_INVALIDARG
Ein Argument ist ungültig.

Hinweise

Server machen Elemente entweder als Elemente (untergeordnete IDs) oder als vollständige Objekte (IAccessible-Schnittstellenzeiger) verfügbar. Wenn ein untergeordnetes Element ein Element ist, gibt get_accChild S_FALSE zurück, und das übergeordnete Element stellt Informationen für dieses untergeordnete Element bereit. Wenn das untergeordnete Objekt ein vollständiges Objekt ist, gibt get_accChild den IAccessible-Schnittstellenzeiger zurück, und das übergeordnete Objekt gibt keine Informationen zu diesem untergeordneten Objekt an. Wenn get_accChild fehlschlägt, weil die Serveranwendung aufgrund eines temporären Systemfehlers (z. B. eines Fehlers aus dem Arbeitsspeicher) kein barrierefreies Objekt erstellen kann, sollte der Server einen geeigneten Fehlercode zurückgeben.

Hinweis für Serverentwickler: Wenn varChildID VT_EMPTY enthält, sollten Sie E_INVALIDARG zurückgeben.

Serverbeispiel

Der folgende Beispielcode zeigt eine Implementierung für ein Objekt, das keine untergeordneten Elemente aufweist oder dessen untergeordnete Elemente anstelle von Objekten sind.

HRESULT STDMETHODCALLTYPE AccServer::get_accChild( 
    VARIANT varChild,
    IDispatch **ppdispChild)
{
    if (varChild.vt != VT_I4)
    {
        *ppdispChild = NULL;
        return E_INVALIDARG;
    }
    *ppdispChild = NULL;    
    return S_FALSE;     
};

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleacc.h
Bibliothek Oleacc.lib
DLL Oleacc.dll
Verteilbare Komponente Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95

Weitere Informationen

AccessibleChildren

Iaccessible

IAccessible::get_accParent

IDispatch

Eigenschaften und Methoden der Objektnavigation

VARIANTE