MAPIERROR
Gilt für: Outlook 2013 | Outlook 2016
Stellt detaillierte Informationen zu einem Fehler bereit, der in der Regel vom Betriebssystem, der MAPI oder einem Dienstanbieter generiert wird.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
typedef struct _MAPIERROR
{
ULONG ulVersion;
LPSTR lpszError;
LPSTR lpszComponent;
ULONG ulLowLevelError;
ULONG ulContext;
} MAPIERROR, FAR * LPMAPIERROR;
Members
ulVersion
Versionsnummer der -Struktur. Der ulVersion-Member wird für zukünftige Erweiterungen verwendet und sollte auf MAPI_ERROR_VERSION festgelegt werden, der derzeit als 0 (null) definiert ist.
lpszError
Zeiger auf eine Zeichenfolge, die den Fehler beschreibt. Diese Zeichenfolge hat das Unicode-Format, wenn der ulFlags-Parameter für die Methode, in der diese Struktur verwendet wird, auf MAPI_UNICODE festgelegt ist.
lpszComponent
Zeiger auf eine Zeichenfolge, die die Komponente beschreibt, die den Fehler generiert hat. Diese Zeichenfolge hat das Unicode-Format, wenn der ulFlags-Parameter für die Methode, in der diese Struktur verwendet wird, auf MAPI_UNICODE festgelegt ist.
ulLowLevelError
Fehlerwert auf niedriger Ebene, der nur verwendet wird, wenn der zurückzugebende Fehler auf niedriger Ebene ist.
ulContext
Wert, der die Position in der Komponente darstellt, auf die der lpszComponent-Member verweist, der den Fehlerort identifiziert.
Hinweise
Die MAPIERROR-Struktur wird verwendet, um Fehlerinformationen zu beschreiben. Clients und Dienstanbieter übergeben einen Zeiger auf eine MAPIERROR-Struktur im lppMAPIError-Parameter der IMAPIProp::GetLastError-Methode . GetLastError gibt Informationen zum vorherigen Fehler zurück, der bei einem Objekt aufgetreten ist. Aufrufer von GetLastError geben den Arbeitsspeicher für die MAPIERROR-Struktur frei, indem sie MAPIFreeBuffer aufrufen.
Der lpszComponent-Member kann verwendet werden, um die Hilfedatei der Komponente zuzuordnen, sofern vorhanden. Dienstanbieter sollten die Größe der Komponentenzeichenfolge auf 30 Zeichen beschränken, damit sie problemlos in einem Dialogfeld angezeigt werden kann. Das ulContext-Element kann auch verwendet werden, um auf ein Online-Hilfethema für häufige Fehler zu verweisen.
Da Dienstanbieter keine detaillierten Fehlerinformationen bereitstellen müssen, sollten Clients nicht erwarten, dass die Member der MAPIERROR-Struktur , die zurückgegeben werden, gültige Daten enthalten. Die MAPI empfiehlt jedoch mindestens dringend, dass Anbieter Informationen in den LpszComponent- und ulContext-Membern angeben.
Weitere Informationen zur Fehlerbehandlung in MAPI finden Sie unter Fehlerbehandlung.