Metodo IDebugHostModule::FindTypeByName (dbgmodel.h)

Il metodo FindTypeByName trova un tipo definito all'interno del modulo in base al nome del tipo e restituisce un simbolo di tipo. Questo metodo può restituire un IDebugHostType valido 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 tenteranno esplicitamente 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, eseguirà 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, un puntatore a o una matrice di ) un tipo trovato nelle informazioni simboliche del modulo.

type

In questo caso verrà restituito un simbolo di tipo per il tipo trovato.

Valore restituito

Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.

Commenti

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 **"
}

Requisiti

Requisito	Valore
Intestazione	dbgmodel.h

Vedi anche

Interfaccia IDebugHostModule