EXCEPINFO
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Beschreibt eine Ausnahme, die während der IDispatch:: Invoke aufgetreten. Weitere Informationen über Ausnahmen finden Sie unter IDispatch:: Invoke und Dispatch-Schnittstelle und API-Funktionen- https://msdn.microsoft.com/de-de/library/ms221328(v=vs.100).
typedef struct FARSTRUCT tagEXCEPINFO
{
unsigned short wCode; // Error code.
Unsigned short wReserved; // Reserved.
BSTR bstrSource; // Exception source.
BSTR bstrDescription; // Exception description.
BSTR bstrHelpFile; // Help file path.
Unsigned long dwHelpContext; // Help context ID.
Void FAR* pvReserved; // Reserved.
HRESULT (STDAPICALLTYPE FAR* pfnDeferredFillIn) // Pointer to a
(struct tagEXCEPINFO FAR*); // function that
// fills in help and
// description info.
SCODE scode; // Return value.
} EXCEPINFO, FAR* LPEXCEPINFO;
Die folgende Tabelle beschreibt die Felder der Struktur EXCEPINFO.
Feldname |
Typ |
Beschreibung |
|---|---|---|
wCode |
unsigned short |
Fehler-Code den Fehler identifiziert. Fehlercodes sollte größer als 1000 sein. Entweder dieses Feld oder Feld Scode muss; ausgefüllt werdender andere muss auf 0 festgelegt werden. |
WReserved |
unsigned short |
Reserviert;sollte auf 0 festgelegt werden. |
BstrSource |
Ein Text, lesbaren Name der Quelle der Ausnahme. Normalerweise ist dies ein Anwendungsname. Dieses Feld sollte von der Implementierung von IDispatch ausgefüllt. |
|
BstrDescription |
BSTR |
Ein Text, lesbaren Beschreibung des Fehlers für Kunden vorgesehen. Wenn keine Beschreibung verfügbar ist, verwenden Sie NULL. |
BstrHelpFile |
BSTR |
Der voll qualifizierte Laufwerk, Pfad und Dateinamen einer Hilfedatei, das Weitere Informationen über den Fehler enthält. Wenn keine Hilfe verfügbar ist, verwenden Sie NULL. |
DwHelpContext |
unsigned long |
Die Hilfekontext-ID des Themas in der Hilfedatei. Dieses Feld muss ausgefüllt werden, wenn das BstrHelpFile-Feld nicht NULL ist. |
PvReserved |
void FAR 1 |
Muss auf NULL festgelegt werden. |
PfnDeferredFillIn |
STDAPICALLTYPE |
Zeiger auf eine Funktion, die eine Struktur EXCEPINFO als Argument annimmt und gibt einen HRESULT-Wert zurück. Wenn zurückgestellt, Ausfüllen nicht gewünscht ist, dieses Feld sollte auf NULL festgelegt werden. |
SCODE |
SCODE |
Ein Rückgabewert, der den Fehler beschreibt. Entweder dieses Feld oder wCode (aber nicht beide); müssen ausgefüllt werdender andere muss auf 0 festgelegt werden. (16-Bit-Versionen von Windows nur.) |
Verwenden Sie Feld PfnDeferredFillIn, um ein Objekt zum verzögern im bstrDescription zurück, BstrHelpFileund DwHelpContext Felder ausfüllen, bis Sie benötigt werden zu aktivieren. Dieses Feld kann verwendet werden, z. B. wenn laden die Zeichenfolge für den Fehler ein zeitaufwändiger Vorgang ist. Um verzögerte auszufüllende zu verwenden, wird das Objekt versetzt einen Funktionszeiger in dieser Steckplatz und ist nicht ausfüllen keines der anderen Felder außer im wCode, die erforderlich ist.
Um zusätzliche Informationen zu erhalten, übergibt der Aufrufer die EXCEPINFO-Struktur wieder an die Pexcepinfo Callback-Funktion, die die zusätzlichen Informationen ausgefüllt. Wenn das ActiveX-Objekt und der ActiveX-Client in verschiedenen Prozessen sind, ruft das ActiveX-Objekt PfnDeferredFillIn vor der Rückgabe an den Controller.