Kontrola stavových kódů dat čítačů

Návratová hodnota funkcí PDH označuje úspěch nebo selhání volání funkce, které se liší od stavu dat čítače. Vždy zkontrolujte člena CStatus u hodnoty čítače, která je vrácena ve strukturách PDH, abyste se ujistili, že vrácená data jsou platná, před jejich použitím. Pokud hodnota člena CStatus nenaznačuje úspěch, nepoužívejte data. Následující jsou možné stavové hodnoty pro čítače:

Hodnota	Význam
PDH_CSTATUS_NO_MACHINE	PDH se nepodařilo připojit k počítači zadanému v cestě čítače. Pokud se tento stav vrátí při přidání čítače, čítač není zcela inicializován. Pokaždé, když se dotaz aktualizuje, pdH připojení opakuje. Po navázání připojení se obnoví normální shromažďování dat.
PDH_CSTATUS_NO_OBJECT	Zadaný počítač byl nalezen, ale zadaný objekt výkonu byl nalezen v počítači. Pokud se tento stav vrátí při přidání čítače, zadaný čítač se do dotazu nezahrne. Pokud je tento stav vrácen aktivním čítačem, data pro tento čítač jsou neplatná. Při každém požádání o data se PDH pokusí získat data čítače.
PDH_CSTATUS_NO_INSTANCE	Zadaná instance nebyla v objektu nalezena. Pokud se tento stav vrátí při přidání čítače do dotazu, čítač se úspěšně přidá do dotazu, ale dokud se nezobrazí konkrétní instance a nevrátí se úspěšný stav, nebudou k dispozici žádná data.
PDH_CSTATUS_NO_COUNTER	Zadaný čítač nebyl v zadaném objektu nalezen. Pokud se tento stav vrátí při přidání čítače, čítač se do dotazu nepřidá. Pokud se tento stav vrátí po shromažďování dat, data pro tento čítač jsou neplatná. Při každém vyžádání dat se PDH pokusí získat tyto hodnoty čítače.
PDH_CSTATUS_INVALID_DATA	Čítač byl úspěšně nalezen, ale vrácená data nejsou platná. K této chybě může dojít, pokud je hodnota čítače menší než předchozí hodnota. (Vzhledem k tomu, že hodnoty čítačů se vždy zvýší, hodnota čítače se při dosažení maximální hodnoty převrací na nulu.) Další možnou příčinou je systémový časovač, který není správný.
PDH_CSTATUS_VALID_DATA	Data pro čítač byla úspěšně vrácena, ale nezměnila se od posledního načtení čítače.
PDH_CSTATUS_NEW_DATA	Data čítače byla úspěšně získána zpět a liší se od posledního čtení čítače. PDH_CSTATUS_NEW_DATA lze vrátit na čítači sazby, i když je výsledná sazba stejná jako poslední vzorek. Důvodem je to, že nezpracovaná datová hodnota, která se používá při určování této hodnoty stavu, se změnila, nikoli vypočítaná rychlost.
PDH_MORE_DATA	Zadaná vyrovnávací paměť nebyla dostatečně velká, aby ukládala všechna data čítačů. Přidělte větší vyrovnávací paměť a spusťte funkci znovu.
PDH_CSTATUS_POLOŽKA_NEOVĚŘENA	Čítač byl přidán do dotazu, ale nebyl ověřen ani přístupný. Nejsou k dispozici žádné další informace o stavu tohoto čítače.
PDH_CSTATUS_NO_COUNTERNAME	V dotazu nebyl zadán žádný název čítače.
PDH_CSTATUS_NO_COUNTER	Zadaný název čítače nebyl nalezen.
PDH_CSTATUS_BEZ_OBJEKTU	Zadaný objekt výkonu nebyl nalezen.
PDH_CALC_NEGATIVE_DENOMINATOR	Čítač má zápornou hodnotu jmenovatele.
PDH_VÝPOČET_ZÁPORNÉ_ZÁKLADNÍ_ČASOVÉ_JEDNOTKY	Čítač má zápornou hodnotu časového základu.
PDH_VÝPOČET_ZÁPORNÉ_HODNOTY	Čítač má zápornou hodnotu.
PDH_CSTATUS_BEZ_NÁZVU_POČÍTADLA	Nebyla zadána žádná cesta čítače.
PDH_CSTATUS_BAD_COUNTERNAME	Formát cesty čítače není správný.