Ügyfélobjektumok

A hibakereső motorral szinte minden interakció ügyfélobjektumokon keresztül történik, amelyeket gyakran egyszerűen csak ügyfeleknek neveznek. Minden ügyfél biztosítja a felső szintű motorfelületek implementálását. Minden interfész különböző módszereket biztosít, amelyek a motorral és a motoron keresztül a célokkal való interakcióra használhatók. A motor egy példánya számos ügyféllel rendelkezhet, amelyek mindegyike saját állapottal rendelkezik.

Elsődleges ügyfelek

Az elsődleges ügyfél az az ügyfél, amely csatlakozott az aktuális hibakeresési munkamenethez. Kezdetben egy új ügyfélobjektum létrehozásakor nem elsődleges ügyfélről van szó. Az ügyfél elsődleges ügyfélré válik, ha egy cél beszerzésére szolgál (például a CreateProcess2 meghívásával), vagy a ConnectSession használatával csatlakozik a hibakeresési munkamenethez. A hibakereső parancs .clients parancsa csak az elsődleges ügyfeleket listázza.

Visszahívási objektumok

A visszahívási objektumok minden ügyfélnél regisztrálhatók. A visszahívási objektumoknak három típusa van:

1. Bemeneti visszahívási objektumok (vagy bemeneti visszahívások): a motor bemeneti visszahívásokat hív meg bemenet kéréséhez. Egy konzolablakkal rendelkező hibakereső például regisztrálhat egy bemeneti visszahívást, hogy a motor bemenetet biztosítson a felhasználótól, vagy egy hibakereső regisztrálhat egy bemeneti visszahívást, hogy a motor bemenetet biztosítson egy fájlból.

2. Kimeneti visszahívási objektumok (vagy kimeneti visszahívások): a motor meghívja a kimeneti visszahívásokat a kimenet megjelenítéséhez. Egy konzolablakkal rendelkező hibakereső például regisztrálhat egy kimeneti visszahívást a hibakereső kimenetének a felhasználónak való bemutatásához, vagy egy hibakereső regisztrálhat egy kimeneti visszahívást, hogy a kimenetet egy naplófájlba küldje.

3. Eseményvisszahívási objektumok (vagy eseményvisszahívások): a motor meghívja az eseményvisszahívásokat, amikor egy esemény történik egy célban (vagy a motor állapota megváltozik). Egy hibakereső bővítménytár például regisztrálhat egy eseményvisszahívást bizonyos események monitorozásához, vagy automatizált műveletek végrehajtásához egy adott esemény bekövetkezésekor.

Távoli hibakeresés

Az ügyfélobjektumok megkönnyítik a gazdamotor távoli példányai közötti kommunikációt. A DebugConnect függvény létrehoz egy ügyfélobjektumot, amely egy távoli motorpéldányhoz csatlakozik; az ügyfélen meghívott metódusokat a távoli motor hajtja végre, és a rendszer meghívja az ügyféllel helyben regisztrált visszahívási objektumokat, amikor a távoli motor visszahívási hívásokat indít.

További információk

Az ügyfélobjektumok létrehozásával és használatával kapcsolatos részletekért lásd: Visszahívási objektumok használata. A visszahívási objektumok regisztrálásáról további információt a Visszahívási objektumok használata című témakörben talál.