IDebugHostModule2 ::FindTypeByName, méthode (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 une IDebugHostType valide qui ne serait jamais retournée par le biais d’une récursivité explicite des enfants du module. L’hôte de débogage peut autoriser la création de types dérivés : les types qui ne sont jamais utilisés dans le module lui-même, mais dérivés de types qui 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 renvoyer légitimement un symbole de type pour MyStruct ** malgré ce nom de type qui n’apparaît jamais explicitement dans les symboles du module.
De nombreux hôtes de débogage tenteront explicitement de contextualiser le nom de type passé à la méthode FindTypeByName et de trouver un type correspondant dans les informations symboliques en fonction des règles de la langue et non d’une comparaison brute par rapport aux noms de symboles. Si un hôte de débogage n’est pas en mesure de le faire, 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é est retourné ici.
Valeur de retour
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 **"
}
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |