IDebugModule3::GetSymbolInfo
Ruft eine Liste der Pfade ab, die für Symbole sowie die Ergebnisse des Suchens jedes Pfad gefunden wurden.
HRESULT GetSymbolInfo(
SYMBOL_SEARCH_INFO_FIELDS dwFields,
MODULE_SYMBOL_SEARCH_INFO* pInfo
);
int GetSymbolInfo(
enum_SYMBOL_SEARCH_INFO_FIELDS dwFields,
MODULE_SYMBOL_SEARCH_INFO[] pinfo
);
Parameter
dwFields
[in] Eine Kombination von Flags aus dem SYMBOL_SEARCH_INFORMATION_FIELDS-Enumeration angeben, welche Felder von pInfo gefüllt werden sollen.pInfo
[out] Eine MODULE_SYMBOL_SEARCH_INFORMATION Struktur, deren Member mit den angegebenen Informationen gefüllt werden sollen. Wenn dies ein NULL-Wert ist, gibt diese Methode E_INVALIDARGzurück.
Rückgabewert
Wenn die Methode erfolgreich ausgeführt, gibt sie S_OKzurück. Andernfalls wird ein Fehlercode zurückgegeben.
Hinweis
Die zurückgegebene Zeichenfolge (in der MODULE_SYMBOL_SEARCH_INFO Struktur) kann leer sein, auch wenn S_OK zurückgegeben wurde.In diesem Fall gibt es keine zurückzugebenden Informationen, sucht.
Hinweise
Wenn das bstrVerboseSearchInfo Feld der MODULE_SYMBOL_SEARCH_INFO Struktur nicht leer ist, enthält es eine Liste von Pfaden gegesuchten und die Ergebnisse dieser Suche. Die Liste wird mit einem Pfad, gefolgt von den Auslassungszeichen („… ") gefolgt vom Ergebnis. Wenn es mehr als eine Pfad paare Ergebnis gibt, wird jedes Paar von einem „\ r \ n“ (Wagenrückkehr/Zeilenvorschub) Paar getrennt. Das Muster sieht wie folgt aus:
<path> … <result> \ r \ n <path> \ r \ n <path> …… <result> <result>
Beachten Sie, dass der letzte Eintrag keine Sequenz \ r \ n ist.
Beispiel
In diesem Beispiel wird diese Methode drei Pfade mit drei verschiedenen Suchergebnissen zurück. Jede Zeile wird mit einem Wagenrückkehr-/Zeilenvorschubpaar beendet. Das Beispiel, das gerade ausgegeben wird, werden die Suchergebnisse als einzelne Zeichenfolge.
Hinweis
Ein Status ist für alle direkt auf „…“ bis zum Ende der Linie.
void ShowSymbolSearchResults(IDebugModule3 *pIDebugModule3)
{
MODULE_SYMBOL_SEARCH_INFO ssi = { 0 };
HRESULT hr;
hr = pIDebugModule3->GetSymbolInfo(SSIF_VERBOSE_SEARCH_INFO,&ssi);
if (SUCCEEDED(hr)) {
CComBSTR searchInfo = ssi.bstrVerboseSearchInfo;
if (searchInfo.Length() != 0) {
std::wcout << (wchar_t *)(BSTR)searchInfo;
std::wcout << std::endl;
}
}
}
Siehe auch
Referenz
SYMBOL_SEARCH_INFORMATION_FIELDS