IDebugHostModule2::FindTypeByName-Methode (dbgmodel.h)
Die FindTypeByName-Methode sucht einen Typ, der innerhalb des Moduls durch den Typnamen definiert ist, und gibt ein Typsymbol dafür zurück. Diese Methode gibt möglicherweise einen gültigen IDebugHostType zurück, der niemals über eine explizite Rekursion von untergeordneten Elementen des Moduls zurückgegeben wird. Der Debughost kann die Erstellung von abgeleiteten Typen ermöglichen– Typen, die nicht innerhalb des Moduls selbst verwendet werden, sondern von Typen abgeleitet werden. Wenn beispielsweise die Struktur MyStruct in den Symbolen des Moduls definiert ist, der Typ MyStruct ** jedoch nie verwendet wird, kann die FindTypeByName-Methode legitimerweise ein Typsymbol für MyStruct ** zurückgeben, obwohl dieser Typname nie explizit in den Symbolen für das Modul angezeigt wird.
Viele Debughosts versuchen explizit, den Typnamen zu kontextualisieren, der an die FindTypeByName-Methode übergeben wird, und suchen einen übereinstimmenden Typ innerhalb der symbolischen Informationen gemäß den Regeln der Sprache und keinen rohen Vergleich mit Symbolnamen. Für den Fall, dass ein Debughost dies nicht tun kann, wird er auf einen unformatierten Vergleich mit Symbolnamen zurückgreifen.
Syntax
HRESULT FindTypeByName(
PCWSTR typeName,
IDebugHostType **type
);
Parameter
typeName
Der Sprachtyp, der in den symbolischen Informationen für das Modul gesucht werden soll. Der Typ kann auch von einem Typ abgeleitet werden (z. B. ein Zeiger auf oder ein Array von), der sich in den symbolischen Informationen des Moduls befindet.
type
Hier wird ein Typsymbol für den gefundenen Typ zurückgegeben.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Hinweise
Beispielcode
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 **"
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |