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

Weitere Informationen

DbgHelp-Funktionen