IStylusPlugin::Error-Methode (rtscom.h)

Benachrichtigt das implementierende Objekt, dass dieses Plug-In oder eines der vorherigen Plug-Ins in der IStylusAsyncPlugin- oder IStylusSyncPlugin-Auflistung eine Ausnahme ausgelöst hat.

Syntax

HRESULT Error(
  [in]      IRealTimeStylus            *piRtsSrc,
  [in]      IStylusPlugin              *piPlugin,
  [in]      RealTimeStylusDataInterest dataInterest,
  [in]      HRESULT                    hrErrorCode,
  [in, out] LONG_PTR                   *lptrKey
);

Parameter

[in] piRtsSrc

Das RTS-Objekt ( RealTimeStylus Class ), das die Benachrichtigung gesendet hat.

[in] piPlugin

Das IStylusPlugin-Objekt , das die Benachrichtigung gesendet hat.

[in] dataInterest

Bezeichner der IStylusPlugin-Methode , die den Fehler generiert hat.

[in] hrErrorCode

Der HRESULT-Code für den aufgetretenen Fehler.

[in, out] lptrKey

Wird intern vom System verwendet.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.

Hinweise

Diese Methode wird aufgerufen, wenn das RTS-Objekt eine Ausnahme abgefangen hat.

Beispiele

Im folgenden C++-Beispiel wird eine IStylusPlugin::Error-Methode implementiert, die mithilfe des TRACE-Makros eine Meldung und einen Fehlercode an das Debugfenster ausgibt.

STDMETHODIMP CPacketModifier::Error( 
            /* [in] */ IRealTimeStylus *piRtsSrc,
            /* [in] */ IStylusPlugin *piPlugin,
            /* [in] */ RealTimeStylusDataInterest dataInterest,
            /* [in] */ HRESULT hrErrorCode,
            /* [out][in] */ LONG_PTR *lptrKey)
{
	CString strError;
	strError.Format(L"An error occurred. Error code: %d", hrErrorCode);
	TRACE(strError);
	return S_OK;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	rtscom.h
DLL	RTSCom.dll

Weitere Informationen

DynamicRenderer-Klasse

IStylusPlugin-Schnittstelle

IStylusPlugin::D ataInterest-Methode