Klientské objekty

Téměř všechny interakce s modulem ladicího programu jsou prostřednictvím klientských objektů, často se jednoduše označují jako klienti. Každý klient poskytuje implementaci rozhraní modulu nejvyšší úrovně. Každé rozhraní poskytuje jinou sadu metod, které lze použít k interakci se strojem a prostřednictvím stroje k cílům. Instance modulu může mít mnoho klientů, z nichž každý má svůj vlastní stav.

Primární klienti

Primární klient je klient, který se připojil k aktuální relaci ladění. Při vytvoření nového objektu klienta se zpočátku nejedná o primárního klienta. Klient se stane primárním klientem, když se použije k získání cíle (například voláním CreateProcess2) nebo je připojený k ladicí relaci pomocí ConnectSession. Příkaz ladicího programu .clients zobrazí pouze primární klienty.

Objekty zpětného volání

Objekty zpětného volání je možné zaregistrovat u každého klienta. Existují tři typy objektů zpětného volání:

1. Objekty zpětného volání pro vstup (nebo zpětná volání pro vstup): Modul volá zpětná volání pro vstup k vyžádání vstupu. Ladicí program s oknem konzoly může například zaregistrovat zpětné volání vstupu, aby poskytl modulu vstup od uživatele, nebo ladicí program může zaregistrovat zpětné volání vstupu k poskytování vstupu z souboru do modulu.

2. Objekty pro zpětné volání výstupu (nebo zpětná volání pro výstup): Modul volá zpětná volání pro výstup k zobrazení výstupu. Ladicí program s oknem konzoly může například zaregistrovat zpětná volání výstupu pro prezentaci výstupu ladicího programu uživateli nebo ladicí program může zaregistrovat výstupní zpětné volání pro odeslání výstupu do souboru protokolu.

3. Objekty zpětného volání událostí (nebo zpětné volání událostí): Modul volá zpětné volání událostí při každém výskytu události v cíli (nebo je změna stavu modulu). Například knihovna rozšíření ladicího programu může zaregistrovat zpětné volání události pro monitorování určitých událostí nebo provádění automatizovaných akcí, když dojde k určité události.

Vzdálené ladění

Klientské objekty usnadňují komunikaci se vzdálenými instancemi hostitelského modulu. Funkce DebugConnect vytvoří objekt klienta, který je připojen k instanci vzdáleného modulu; Metody volané na tomto klientovi jsou spouštěny vzdáleným modulem a objekty zpětného volání zaregistrované místně v klientovi budou volány, když vzdálený modul provádí volání zpětného volání.

Další informace

Podrobnosti o vytváření a používání klientských objektů naleznete v tématu Použití objektů zpětného volání. Podrobnosti o registraci objektů zpětného volání naleznete v tématu Použití objektů zpětného volání.