AtlReportError

HRESULT WINAPI AtlReportError (const CLSIDamp; identyfikator CLSID, LPCOLESTR lpszDescStała Identyfikator IID & identyfikator IID = GUID_NULL, HRESULT parametrem typu HRESULT = 0 );

HRESULT WINAPI AtlReportError (const CLSIDamp; identyfikator CLSID, LPCOLESTR lpszDescDWORDdwHelpIDLPCOLESTRlpszHelpFileStała Identyfikator IID & identyfikator IID = GUID_NULL, HRESULT parametrem typu HRESULT = 0 );

HRESULT WINAPI AtlReportError (const CLSIDamp; identyfikator CLSID, LPCSTR lpszDesc, Stała Identyfikator IID & identyfikator IID = GUID_NULL, HRESULT parametrem typu HRESULT = 0 );

HRESULT WINAPI AtlReportError (const CLSIDamp; identyfikator CLSID, LPCSTR lpszDescDWORDdwHelpIDLPCSTRlpszHelpFileStała Identyfikator IID & identyfikator IID = GUID_NULL, HRESULT parametrem typu HRESULT = 0 );

HRESULT WINAPI AtlReportError (const CLSIDamp; identyfikator CLSID, UINT nID, Stała Identyfikator IID & identyfikator IID = GUID_NULL, HRESULT parametrem typu HRESULT = 0, Wystąpienie HINSTANCEhInst= _Module.GetResourceInstance ());

HRESULT WINAPI AtlReportError (const CLSIDamp; identyfikator CLSID, UINT nIDDWORDdwHelpIDLPCOLESTRlpszHelpFileStała Identyfikator IID & identyfikator IID = GUID_NULL, HRESULT parametrem typu HRESULT = 0, Wystąpienie HINSTANCEhInst= _Module.GetResourceInstance ());

Wartość zwracany

Jeśli parametr parametrem typu HRESULT jest niezerowa, zwraca wartość parametrem typu HRESULT. Jeśli parametrem typu HRESULT jest równe zero, pierwsze cztery wersje AtlReportError zwraca DISP_E_EXCEPTION. Ostatnie dwie wersje zwracają wynik makro MAKE_HRESULT (1, FACILITY_ITF, nID ).

Parametry

identyfikator clsid

[w] Identyfikator CLSID obiektu raportowania błędów.

lpszDesc

[w] Ciąg opisujący ten błąd. Wersja Unicode określa, że ta lpszDesc jest typu LPCOLESTR; wersja ANSI określa rodzaj LPCSTR.

identyfikator iid

[w] IID interfejsu definiowanie błąd lub GUID_NULL , jeżeli błąd jest zdefiniowana przez system operacyjny.

parametrem typu HRESULT

[w] HRESULT , którą chcesz powrócił do wywołującego.

nID

[w] Identyfikator zasobu, gdzie znajduje się ciąg opis błędu. Ta wartość musi zawierać się między 0x0200 a 0xFFFF, łącznie. W debugowania kompilacje ASSERT spowoduje Jeśli nID nie indeksują prawidłowym ciągiem. W wersji kompilacji ciąg opisu błąd zostanie ustawiony na "Nieznany błąd."

dwHelpID

[w] Identyfikator kontekstu Pomoc dla błędu.

lpszHelpFile

[w] Ścieżka i nazwa pliku pomocy, opisem błędu.

hInst

[w] Uchwyt do zasobu. Domyślnie ten parametr jest _Module::GetResourceInstance, gdzie _Module jest globalne instancji klasy pochodzące z niego lub CComModule.

Uwagi

Konfiguruje IErrorInfo interfejsu do dostarczenia informacji o błędach klientom obiektu. Ciąg lpszDesc jest używana jako tekstowy opis błędu. Gdy klient odbierze parametrem typu HRESULT , który zwraca z AtlReportError, klient może uzyskać dostęp strukturę IErrorInfo , aby uzyskać szczegółowe informacje o błędzie.

ATL makra i funkcje globalne

Zobacz też

MAKE_HRESULT

Index