Méthode IDebugHostModule ::FindTypeByName (dbgmodel.h)

  • Article

La méthode FindTypeByName recherche un type défini dans le module par le nom de type et retourne un symbole de type pour celui-ci. Cette méthode peut retourner un IDebugHostType valide qui ne serait jamais retourné via une récursivité explicite des enfants du module. L’hôte de débogage peut autoriser la création de types dérivés , des types qui ne sont pas jamais utilisés dans le module lui-même, mais dérivés de types qui le sont. Par exemple, si la structure MyStruct est définie dans les symboles du module mais que le type MyStruct ** n’est jamais utilisé, la méthode FindTypeByName peut légitimement renvoyer un symbole de type pour MyStruct ** même si ce nom de type n’apparaît jamais explicitement dans les symboles du module.

De nombreux hôtes de débogage effectuent une tentative explicite de contextualisation du nom de type qui est passé à la méthode FindTypeByName et recherchent un type correspondant dans les informations symboliques en fonction des règles du langage et non d’une comparaison brute avec les noms de symboles. Dans le cas où un hôte de débogage ne peut pas effectuer cette opération, il revient à une comparaison brute par rapport aux noms de symboles.

Syntaxe

HRESULT FindTypeByName(
  PCWSTR         typeName,
  IDebugHostType **type
);

Paramètres

typeName

Type de langue à rechercher dans les informations symboliques du module. Le type peut également être dérivé (par exemple, être un pointeur vers ou un tableau de) d’un type trouvé dans les informations symboliques du module.

type

Un symbole de type pour le type trouvé sera retourné ici.

Valeur retournée

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

Exemple de Code

ComPtr<IDebugHostModule> spModule; /* get a module (see FindModuleByName) */

// Find "MyStruct **".  Note that only "MyStruct" might be in the symbols
ComPtr<IDebugHostType> spType;
if (SUCCEEDED(spModule->FindTypeByName(L"MyStruct **", &spType)))
{
    // spType contains a type symbol for "MyStruct **"
}

Configuration requise

Condition requise Valeur
En-tête dbgmodel.h

Voir aussi

Interface IDebugHostModule