IAccessible::get_accChild-Methode (oleacc.h)

Artikel
08/25/2023

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