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 |
|---|---|
|
Mindestens ein Argument ist ungültig. |
|
Das im pAcc-Parameter angegebene Objekt unterstützt die im riid-Parameter angegebene Schnittstelle nicht. |
|
Unzureichender Arbeitsspeicher zum Speichern des Objektverweis. |
|
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 |