Funzione SymSrvGetFileIndexString (dbghelp.h)
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 |