Metodo IDebugHostModule::FindTypeByName (dbgmodel.h)
Il metodo FindTypeByName trova un tipo definito all'interno del modulo in base al nome del tipo e ne restituisce un simbolo di tipo. Questo metodo può restituire un valido IDebugHostType che non verrebbe mai restituito tramite ricorsione esplicita degli elementi figlio del modulo. L'host di debug può consentire la creazione di tipi derivati, ovvero tipi non mai usati all'interno del modulo stesso, ma derivati da tipi che sono. Ad esempio, se la struttura MyStruct è definita nei simboli del modulo ma il tipo MyStruct ** non viene mai usato, il metodo FindTypeByName può restituire legittimamente un simbolo di tipo per MyStruct ** nonostante tale nome di tipo non venga mai visualizzato in modo esplicito nei simboli per il modulo.
Molti host di debug effettueranno un tentativo esplicito di contestualizzare il nome del tipo passato al metodo FindTypeByName e di trovare un tipo corrispondente all'interno delle informazioni simboliche in base alle regole della lingua e non a un confronto non elaborato con i nomi dei simboli. Nel caso in cui un host di debug non sia in grado di eseguire questa operazione, verrà eseguito il fallback al confronto non elaborato con i nomi dei simboli.
Sintassi
HRESULT FindTypeByName(
PCWSTR typeName,
IDebugHostType **type
);
Parametri
typeName
Tipo di linguaggio da trovare nelle informazioni simbolica per il modulo. Il tipo può anche essere derivato da (ad esempio, essere un puntatore a o una matrice di ) un tipo trovato nelle informazioni simboliche del modulo.
type
Qui verrà restituito un simbolo di tipo per il tipo trovato.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.
Osservazioni
codice di esempio
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 **"
}
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | dbgmodel.h |