Funzione SymSrvGetFileIndexString (dbghelp.h)

  • Articolo

Recupera la stringa di indice per il file con estensione pdb, dbg o image specificato.

Sintassi

BOOL IMAGEAPI SymSrvGetFileIndexString(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [in]           PCSTR  File,
  [out]          PSTR   Index,
  [in]           size_t Size,
  [in]           DWORD  Flags
);

Parametri

[in] hProcess

Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .

[in, optional] SrvPath

Percorso del server di simboli.

[in] File

Nome del file.

[out] Index

Puntatore a un buffer che riceve la stringa di indice.

[in] Size

Dimensioni del buffer index , in caratteri.

[in] Flags

Questo parametro è riservato per usi futuri.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Questa funzione non è per l'uso generale. Tali utilità di scrittura per la gestione dei file negli archivi del server dei simboli possono usare per questa funzione per prevedere il percorso relativo che il server simboli cercherà un file. Viene usato da srctool.exe per popolare effettivamente gli archivi server dei simboli.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione dbghelp.h
Libreria DbgHelp.lib
DLL DbgHelp.dll
Componente ridistribuibile DbgHelp.dll 6.3 o versione successiva

Vedi anche

Funzioni DbgHelp