HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCOLESTR lpszDescconst IID & IID GUID_NULL, HRESULT = hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCOLESTR lpszDescDWORDdwHelpIDLPCOLESTRlpszHelpFileconst IID & IID GUID_NULL, HRESULT = hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCSTR lpszDesc, const IID & IID = GUID_NULL, HRESULT hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCSTR lpszDescDWORDdwHelpIDLPCSTRlpszHelpFileconst IID & IID GUID_NULL, HRESULT = hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, UINT nID, const IID & IID GUID_NULL, HRESULT = hRes = 0, HINSTANCEhInst= _Module.GetResourceInstance ());
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, UINT nIDDWORDdwHelpIDLPCOLESTRlpszHelpFileconst IID & IID GUID_NULL, HRESULT = hRes = 0, HINSTANCEhInst= _Module.GetResourceInstance ());
Rückgabewert
Wenn der hRes -Parameter ungleich NULL ist, gibt den Wert der hRes. Wenn hRes NULL ist, geben die ersten vier Versionen von AtlReportError DISP_E_EXCEPTIONzurück. Die letzten beiden Versionen zurück, das Ergebnis des Makros MAKE_HRESULT (1, FACILITY_ITF, nID ).
Parameter
clsid
[in] Die CLSID des Objekts, die den Fehler meldet.
lpszDesc
[in] Die Zeichenfolge, die den Fehler beschreibt. Die Unicode-Version angibt, dass die LpszDesc vom Typ LPCOLESTRist; die ANSI-Version gibt einen Typ der LPCSTR.
iid
[in] Die IID der Schnittstelle, die Fehler oder GUID_NULL definieren, wenn der Fehler vom Betriebssystem definiert ist.
hRes
[in] Gewünschte HRESULT zurückgegeben an den Aufrufer.
nID
[in] Der Ressourcenbezeichner, wo der Fehler Beschreibung String gespeichert wird. Dieser Wert sollte zwischen 0 x 0200 und 0xFFFF, einschließlich liegen. In Debugbuilds führt ein ASSERT , wenn nID eine gültige Zeichenfolge nicht indiziert ist. In Releasebuilds wird die Beschreibungszeichenfolge Fehler "Unbekannter Fehler." festgelegt werden
dwHelpID
[in] Den Kontextbezeichner der Hilfe für den Fehler.
lpszHelpFile
[in] Der Pfad und Name der Hilfedatei, die den Fehler beschreibt.
hInst
[in] Das Handle für die Ressource. Standardmäßig ist dieser Parameter _Module::GetResourceInstance, wobei _Module die globale Instanz von CComModule oder einer davon abgeleiteten Klasse.
Bemerkungen
Richtet die IErrorInfo -Schnittstelle, um Fehlerinformationen für Clients des Objekts bereitzustellen. Die Zeichenfolge LpszDesc dient als die Textbeschreibung des Fehlers. Wenn der Client die hRes , die von AtlReportErrorzurückgegeben empfängt, kann der Client die IErrorInfo -Struktur für Informationen über den Fehler zugreifen.
ATL-Makros und globale Funktionen
Siehe auch