CComCoClass::Error
Ustawia statyczny funkcja IErrorInfo interfejsu do dostarczania informacji o błędzie do klienta.
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()
);
Parametry
lpszDesc
[w] Ciąg opisujący błąd.Wersja Unicode Error Określa, że lpszDesc jest typu LPCOLESTR; wersja ANSI określa typ LPCSTR.iid
[w] Identyfikator IID interfejsu Definiowanie błąd lub GUID_NULL (wartość domyślna) Jeśli błąd jest zdefiniowana przez system operacyjny.hRes
[w] HRESULT Mają być zwracane do obiektu wywołującego.Wartością domyślną jest 0.Więcej szczegółów dotyczących hRes, zobacz uwagi.nID
[w] Identyfikator zasobu, gdzie przechowywane są ciąg opis błędu.Ta wartość musi zawierać się między 0x0200 i 0xFFFF, łącznie.W kompilacjach debugowania ASSERT spowoduje, że jeśli nID prawidłowy ciąg nie indeks.W trybie budowania wersji ciąg opisu błąd zostanie ustawiony na "Nieznany błąd".dwHelpID
[w] Identyfikator kontekstu pomocy błędu.lpszHelpFile
[w] Ścieżka i nazwa pliku pomocy opisem błędu.hInst
[w] Dojścia do zasobu.Domyślnie ten parametr jest _AtlModule::GetResourceInstance, gdzie _AtlModule jest globalne wystąpienie CAtlModule.
Wartość zwracana
Standard HRESULT wartości.Aby uzyskać szczegółowe informacje Zobacz uwagi.
Uwagi
Wywołanie Error, obiekt musi implementować ISupportErrorInfo Interface interfejsu.
Jeśli hRes parametr jest niezerowa, następnie Error zwraca wartość hRes.Jeśli hRes jest zero, a następnie pierwsze cztery wersje Error zwrotu DISP_E_EXCEPTION.Ostatnie dwie wersje zwracają wynik makra MAKE_HRESULT (1, FACILITY_ITF,nID).
Wymagania
Nagłówek: atlcom.h