Freigeben über


CComCoClass::Error

Diese statische Funktion werden die IErrorInfo-Schnittstelle, um Fehlerinformationen an den Client bereitzustellen.

static HRESULT WINAPI Error(
   LPCOLESTR lpszDesc,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   LPCOLESTR lpszDesc,
   DWORD dwHelpID,
   LPCOLESTR lpszHelpFile,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   LPCSTR lpszDesc,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   LPCSTR lpszDesc,
   DWORD dwHelpID,
   LPCSTR lpszHelpFile,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   UINT nID,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0,
   HINSTANCE hInst = _AtlBaseModule.GetResourceInstance ()
);
static HRESULT Error(
   UINT nID,
   DWORD dwHelpID,
   LPCOLESTR lpszHelpFile,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0,
   HINSTANCE hInst = _AtlBaseModule.GetResourceInstance() 
);

Parameter

  • lpszDesc
    [in] Die Zeichenfolge, die den Fehler beschreibt.Die Unicode-Version von Error gibt an, dass lpszDesc vom Typ ist, LPCOLESTR die ANSI-Version gibt einen Typ LPCSTR an.

  • iid
    [in] Die IID der Schnittstelle, die den Fehler oder GUID_NULL (den Standardwert) definiert wenn der Fehler vom Betriebssystem definiert wird.

  • hRes
    [in] HRESULT, das Sie an den Aufrufer zurückgegeben werden soll.Der Standardwert ist 0.Weitere Informationen über hRes, siehe Hinweise.

  • nID
    [in] Der Ressourcenbezeichner, in dem die Fehlerbeschreibungszeichenfolge gespeichert wird.Dieser Wert sollte zwischen 0x0200 und 0xFFFF liegen, einschließlich.In Debugbuilds ASSERT tritt auf, wenn nID keine gültige Zeichenfolge indiziert.In Releasebuilds ist die Fehlerbeschreibungszeichenfolge festgelegter "unbekannter Fehler".

  • dwHelpID
    [in] Der Hilfekontextbezeichner für den Fehler.

  • lpszHelpFile
    [in] Der Datei Pfad und Name der Hilfe die Beschreibung des Fehlers.

  • hInst
    [in] Das Handle auf die Ressource.Standardmäßig ist dieser Parameter _AtlModule::GetResourceInstance, in dem _AtlModule die globale Instanz von CAtlModule ist.

Rückgabewert

Ein HRESULT-Standardwert.Details finden Sie Hinweise.

Hinweise

Um Error aufzurufen, muss das Objekt die ISupportErrorInfo Interface-Schnittstelle implementieren.

Wenn der hRes-Parameter ungleich 0 (null) ist, gibt Error den Wert von hRes zurück.Wenn hRes null ist, dann die ersten vier Versionen von Error Rückgabe DISP_E_EXCEPTION.Die letzten zwei Versionen geben das Ergebnis des Makros MAKE_HRESULT( 1, FACILITY_ITF, nID ) zurück.

Anforderungen

Header: möchten

Siehe auch

Referenz

CComCoClass-Klasse

ISupportErrorInfoImpl-Klasse

MAKE_HRESULT