LresultFromObject-Funktion (oleacc.h)

Gibt einen Verweis ähnlich einem Handle auf das angegebene Objekt zurück. Server geben diesen Verweis zurück, wenn sie WM_GETOBJECT verarbeiten.

Syntax

LRESULT LresultFromObject(
  [in] REFIID    riid,
  [in] WPARAM    wParam,
  [in] LPUNKNOWN punk
);

Parameter

[in] riid

Typ: REFIID

Verweisbezeichner der schnittstelle, die für den Client bereitgestellt wird. Dieser Parameter ist IID_IAccessible.

[in] wParam

Typ: WPARAM

Der Wert, der von der zugeordneten WM_GETOBJECT Nachricht im wParam-Parameter gesendet wird.

[in] punk

Typ: LPUNKNOWN

Adresse der IAccessible-Schnittstelle für das Objekt, das der WM_GETOBJECT Nachricht entspricht.

Rückgabewert

Typ: LRESULT

Bei erfolgreicher Ausführung wird ein positiver Wert zurückgegeben, der ein Verweis auf das -Objekt ist.

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

Rückgabecode Beschreibung
E_INVALIDARG
Mindestens ein Argument ist ungültig.
E_NOINTERFACE
Das im pAcc-Parameter angegebene Objekt unterstützt die im riid-Parameter angegebene Schnittstelle nicht.
E_OUTOFMEMORY
Unzureichender Arbeitsspeicher zum Speichern des Objektverweis.
E_UNEXPECTED
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Server rufen diese Funktion nur bei der Behandlung der WM_GETOBJECT-Nachricht auf. Eine Übersicht über die Beziehung zwischen LresultFromObject und WM_GETOBJECT finden Sie unter Funktionsweise WM_GETOBJECT.

LresultFromObject erhöht die Verweisanzahl des Objekts. Wenn Sie den an die Funktion übergebenen Schnittstellenzeiger nicht speichern (d. h., Sie erstellen bei jedem Empfang WM_GETOBJECT einen neuen Schnittstellenzeiger für das Objekt), rufen Sie die Release-Methode des Objekts auf, um die Verweisanzahl wieder auf eins zu verringern. Anschließend ruft der Client Release auf, und das Objekt wird zerstört. Weitere Informationen finden Sie unter Behandeln von WM_GETOBJECT.

Jedes Mal, wenn ein Server WM_GETOBJECT für ein bestimmtes Objekt verarbeitet, ruft er LresultFromObject auf, um einen neuen Verweis auf das Objekt abzurufen. Server speichern den von LresultFromObject zurückgegebenen Verweis nicht aus einem instance der Verarbeitung WM_GETOBJECT, um als Rückgabewert der Nachricht zu verwenden, wenn nachfolgende WM_GETOBJECT Nachrichten für dasselbe Objekt verarbeitet werden. Dies führt dazu, dass der Client einen Fehler erhält.

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

Erstellen von Proxyobjekten

Funktionsweise von WM_GETOBJECT

Behandeln von WM_GETOBJECT

WM_GETOBJECT