IDebugHostModule5::FindSymbolByName-Methode (dbgmodel.h)

Die FindSymbolByName-Methode findet ein einzelnes globales Symbol des angegebenen Namens innerhalb des Moduls. Wenn kein einzelnes Symbol vorhanden ist, das dem angegebenen Namen entspricht, wird von dieser Methode ein Fehler zurückgegeben. Beachten Sie, dass diese Methode lieber ein privates Symbol über ein Symbol in der öffentlichen Tabelle zurückgibt.

Syntax

HRESULT FindSymbolByName(
  PCWSTR           symbolName,
  IDebugHostSymbol **symbol
);

Parameter

symbolName

Der Name des Symbols, das innerhalb der symbolischen Informationen für das Modul gefunden werden soll.

symbol

Das gefundene Symbol wird hier zurückgegeben.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.

Bemerkungen

Beispielcode-

ComPtr<IDebugHostModule5> spModule; /* get a module (see FindModuleByName) */

// Find the symbol for g_someGlobal;
ComPtr<IDebugHostSymbol> spSymbol;
if (SUCCEEDED(spModule->FindSymbolByName(L"g_someGlobal", &spSymbol)))
{
    // spSymbol contains the symbol for g_someGlobal.  It may be any kind of symbol.
}

Anforderungen

Siehe auch

IDebugHostModule5-Schnittstelle