IAccessibleHandler::AccessibleObjectFromID-Methode (oleacc.h)

Artikel
03/06/2024

Die AccessibleObjectFromID-Methode ruft einen IAccessible-Schnittstellenzeiger für die Der angegebenen Objekt-ID zugeordnete Schnittstelle ab. Oleacc.dll verwendet diese Methode, um einen IAccessible-Schnittstellenzeiger für Proxys abzurufen, die von anderen Code bereitgestellt werden.

HinweisIAccessibleHandler::AccessibleObjectFromID ist veraltet und sollte nicht verwendet werden.

Syntax

HRESULT AccessibleObjectFromID(
  [in]  long         hwnd,
  [in]  long         lObjectID,
  [out] LPACCESSIBLE *pIAccessible
);

Parameter

[in] hwnd

Typ: long

Gibt das Handle eines Fensters an, für das ein IAccessible-Schnittstellenzeiger abgerufen werden soll.

[in] lObjectID

Typ: long

Gibt die Objekt-ID an. Dieser Wert ist eine der Standardobjektbezeichnerkonstanten oder eine benutzerdefinierte Objekt-ID.

[out] pIAccessible

Typ: LPACCESSIBLE*

Gibt die Adresse einer Zeigervariable an, die die Adresse der IAccessible-Schnittstelle des Objekts empfängt .

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, gibt einen der folgenden oder einen anderen COM-Standardfehlercode zurück.

Fehler	BESCHREIBUNG
E_INVALIDARG	Ein Argument ist ungültig.
E_NOINTERFACE	Die angeforderte Schnittstelle wird nicht unterstützt.

Bemerkungen

Oleacc ruft diese Funktion auf, um einen IAccessible-Schnittstellenzeiger für HWNDsabzurufen, die den Klassennamen haben, für den dieser Handler registriert ist.

Beim Start sucht Oleacc den Registrierungsschlüssel HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers und listet jeden Unterschlüssel auf (Oleacc erwartet, dass der Unterschlüssel eine GUID ist). Oleacc liest den zugehörigen Klassennamen aus HKCR\CLSID{guid}\AccClassName, wobei {guid} die GUID unter dem Schlüssel HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers war. Wenn Oleacc ein Fenster mit einem Klassennamen findet, der der GUID entspricht, wird das Objekt mithilfe der GUID coCreates ausgeführt, der IAccessibleHandler-Schnittstellenzeiger abgerufen und AccessibleObjectFromID aufgerufen, um den IAccessible-Schnittstellenzeiger abzurufen.

Wie bei anderen IAccessible-Methoden und Funktionen erhalten Clients aufgrund einer Benutzeraktion möglicherweise Fehler für IAccessible-Schnittstellenzeiger . Weitere Informationen finden Sie unter Empfangen von Fehlern für IAccessible-Schnittstellenzeiger.

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

Freigeben über