Sdílet prostřednictvím


Zpracování chyb v modelu COM (COM)

Téměř všechny funkce modelu COM a metody rozhraní vrací hodnotu typu HRESULT. HRESULT (název se dá přečíst jako popisovač výsledku) je způsob, jak vrátit úspěšnou, upozorňující nebo chybovou hodnotu. HRESULT ve skutečnosti není popisovač (viz Proč HRESULT začíná H, když není popisovač k ničemu?); je to jen hodnota s několika poli zakódovanými do ní. Podle specifikace modelu COM výsledek nuly značí úspěch a nenulový výsledek značí selhání.

Na úrovni zdrojového kódu se všechny chybové hodnoty skládají ze tří částí oddělených podtržítky. První část je předpona, která identifikuje zařízení přidružené k chybě, druhá část je E pro chybu a třetí část je řetězec, který popisuje skutečnou podmínku. Například STG_E_MEDIUMFULL se vrátí, když na pevném disku nezůstane žádné místo. Předpona stG označuje úložné zařízení, E indikuje, že stavový kód představuje chybu, a MEDIUMFULL poskytuje konkrétní informace o chybě. Mnoho hodnot, které můžete chtít vrátit z metody rozhraní nebo funkce, jsou definovány v winerror.h.

Další informace o zpracování chyb najdete v následujících částech:

kódy chyb modelu COM