SymSrvGetFileIndexes-Funktion (dbghelp.h)
Ruft die Indizes für die angegebene PDB-, DBG- oder Imagedatei ab, die zum Speichern der Datei verwendet wird. Die Kombination dieser Werte identifiziert die Datei auf dem Symbolserver eindeutig. Sie können verwendet werden, wenn die SymFindFileInPath-Funktion aufgerufen wird, um in einem Symbolspeicher nach einer Datei zu suchen.
Syntax
BOOL IMAGEAPI SymSrvGetFileIndexes(
[in] PCSTR File,
[out] GUID *Id,
[out] PDWORD Val1,
[out, optional] PDWORD Val2,
[in] DWORD Flags
);
Parameter
[in] File
Der Name der Datei.
[out] Id
Der erste von drei identifizierenden Parametern.
[out] Val1
Der zweite von drei identifizierenden Parametern.
[out, optional] Val2
Der dritte von drei identifizierenden Parametern.
[in] Flags
Dieser Parameter ist für die zukünftige Verwendung reserviert.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Bibliothek | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Verteilbare Komponente | DbgHelp.dll 6.3 oder höher |