CDBErrorInfo – třída
Poskytuje podporu pro zpracování chyb OLE DB pomocí rozhraní OLE DB IErrorRecords .
Syntaxe
class CDBErrorInfo
Požadavky
Hlavička: atldbcli.h
Členové
Metody
| Název | Popis |
|---|---|
| GetAllErrorInfo | Vrátí všechny informace o chybě obsažené v záznamu chyby. |
| GetBasicErrorInfo | Volá IErrorRecords::GetBasicErrorInfo pro vrácení základních informací o zadané chybě. |
| GetCustomErrorObject | Volá IErrorRecords::GetCustomErrorObject k vrácení ukazatele na rozhraní vlastního objektu chyby. |
| GetErrorInfo | Volá IErrorRecords::GetErrorInfo k vrácení IErrorInfo ukazatele rozhraní na zadaný záznam. |
| GetErrorParameters | Volá IErrorRecords::GetErrorParameters pro vrácení parametrů chyby. |
| GetErrorRecords | Získá chybové záznamy pro zadaný objekt. |
Poznámky
Toto rozhraní uživateli vrátí jeden nebo více záznamů chyb. Nejprve volejte CDBErrorInfo::GetErrorRecords , abyste získali počet záznamů chyb. Potom zavolejte jednu z přístupových funkcí, například CDBErrorInfo::GetAllErrorInfo, a načtěte informace o chybě pro každý záznam.
CDBErrorInfo::GetAllErrorInfo
Vrátí všechny typy informací o chybách obsažené v záznamu chyby.
Syntaxe
HRESULT GetAllErrorInfo(ULONG ulRecordNum,
LCID lcid, BSTR* pbstrDescription,
BSTR* pbstrSource = NULL,
GUID* pguid = NULL,
DWORD* pdwHelpContext = NULL,
BSTR* pbstrHelpFile = NULL) const throw();
Parametry
UlRecordNum
[v] Číslo záznamu založeného na nule, pro který se mají vrátit informace o chybě.
lcid
[v] ID národního prostředí pro informace o chybě, které se mají vrátit.
pbstrDescription
[ven] Ukazatel na textový popis chyby nebo hodnoty NULL, pokud národní prostředí není podporováno. Viz poznámky.
pbstrSource
[ven] Ukazatel na řetězec obsahující název komponenty, která vygenerovala chybu.
pguid
[ven] Ukazatel na identifikátor GUID rozhraní, které definovalo chybu.
pdwHelpContext
[ven] Ukazatel na ID kontextu nápovědy pro chybu.
pbstrHelpFile
[ven] Ukazatel na řetězec obsahující cestu k souboru nápovědy, který popisuje chybu.
Návratová hodnota
S_OK v případě úspěchu. Další návratové hodnoty naleznete v části IErrorRecords::GetErrorInfo v referenčních informacích programátora OLE DB.
Poznámky
Výstupní hodnota pbstrDescription se získá interně voláním IErrorInfo::GetDescription, který nastaví hodnotu NULL, pokud národní prostředí není podporováno, nebo pokud jsou splněny obě následující podmínky:
hodnota lcid je NOT U.S. Angličtina a
hodnota lcid není rovna hodnotě vrácené GetUserDefaultLCID.
CDBErrorInfo::GetBasicErrorInfo
Volá IErrorRecords::GetBasicErrorInfo k vrácení základních informací o chybě, jako je návratový kód a číslo chyby specifické pro zprostředkovatele.
Syntaxe
HRESULT GetBasicErrorInfo(ULONG ulRecordNum,
ERRORINFO* pErrorInfo) const throw();
Parametry
Viz IErrorRecords::GetBasicErrorInfo v referenční dokumentaci programátora OLE DB.
Návratová hodnota
Standardní HODNOTA HRESULT.
CDBErrorInfo::GetCustomErrorObject
Volá IErrorRecords::GetCustomErrorObject k vrácení ukazatele na rozhraní vlastního objektu chyby.
Syntaxe
HRESULT GetCustomErrorObject(ULONG ulRecordNum,
REFIID riid,IUnknown** ppObject) const throw();
Parametry
Viz IErrorRecords::GetCustomErrorObject v referenční dokumentaci programátora OLE DB.
Návratová hodnota
Standardní HODNOTA HRESULT.
CDBErrorInfo::GetErrorInfo
Volá IErrorRecords::GetErrorInfo pro vrácení ukazatele rozhraní IErrorInfo na zadaný záznam.
Syntaxe
HRESULT GetErrorInfo(ULONG ulRecordNum,
LCID lcid,IErrorInfo** ppErrorInfo) const throw();
Parametry
Viz IErrorRecords::GetErrorInfo v referenční dokumentaci programátora OLE DB.
Návratová hodnota
Standardní HODNOTA HRESULT.
CDBErrorInfo::GetErrorParameters
Volá IErrorRecords::GetErrorParameters pro vrácení parametrů chyby.
Syntaxe
HRESULT GetErrorParameters(ULONG ulRecordNum,
DISPPARAMS* pdispparams) const throw();
Parametry
Viz IErrorRecords::GetErrorParameters v referenční dokumentaci programátora OLE DB.
Návratová hodnota
Standardní HODNOTA HRESULT.
CDBErrorInfo::GetErrorRecords
Získá chybové záznamy pro zadaný objekt.
Syntaxe
HRESULT GetErrorRecords(IUnknown* pUnk,
const IID& iid,
ULONG* pcRecords) throw();
HRESULT GetErrorRecords(ULONG* pcRecords) throw();
Parametry
punk
[v] Rozhraní pro objekt, pro který se mají zobrazit chybové záznamy.
iid
[v] IID rozhraní spojeného s chybou.
PcRecords
[ven] Ukazatel na počet záznamů chyb (1)
Návratová hodnota
Standardní HODNOTA HRESULT.
Poznámky
Pokud chcete zkontrolovat, ze kterého rozhraní chcete získat informace o chybě, použijte první formu funkce. V opačném případě použijte druhý formulář.
Viz také
DBViewer
Šablony příjemců OLE DB
Referenční dokumentace k šablonám příjemců OLE DB