Méthode IDebugHostModule ::FindTypeByName (dbgmodel.h)
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 |