Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Individua un file di simboli o un'immagine eseguibile.
Sintassi
BOOL IMAGEAPI SymFindFileInPathW(
[in] HANDLE hprocess,
[in, optional] PCWSTR SearchPath,
[in] PCWSTR FileName,
[in, optional] PVOID id,
[in] DWORD two,
[in] DWORD three,
[in] DWORD flags,
[out] PWSTR FoundFile,
[in, optional] PFINDFILEINPATHCALLBACKW callback,
[in, optional] PVOID context
);
Parametri
[in] hprocess
Handle per il processo passato originariamente alla funzione SymInitialize.
[in, optional] SearchPath
Percorso di ricerca. Può trattarsi di più percorsi separati da punti e virgola. Può includere sia directory che server di simboli. Se questo parametro è NULL, la funzione usa il percorso di ricerca impostato usando la funzione SymSetSearchPath o SymInitialize.
[in] FileName
Nome del file. È possibile specificare un percorso; tuttavia, viene usato solo il nome del file.
[in, optional] id
Il primo di tre parametri di identificazione (vedere la sezione Osservazioni).
[in] two
Secondo di tre parametri di identificazione (vedere la sezione Note).
[in] three
Terzo dei tre parametri di identificazione (vedere la sezione Osservazioni).
[in] flags
Formato del parametro id . Questo parametro può essere uno dei valori seguenti.
[out] FoundFile
Puntatore a un buffer che riceve il percorso completo del file di simboli. Questo buffer deve essere almeno MAX_PATH caratteri.
[in, optional] callback
funzione di callback SymFindFileInPathPro c.
[in, optional] context
Valore definito dall'utente o NULL. Questo valore viene semplicemente passato alla funzione di callback. Questo parametro viene in genere usato da un'applicazione per passare un puntatore a una struttura di dati che fornisce un contesto per la funzione di callback.
Valore restituito
Se il server individua un file di simboli valido, restituisce TRUE; in caso contrario, restituisce FALSE e GetLastError restituisce un valore che indica il motivo per cui il file di simboli non è stato restituito.
Osservazioni
I parametri di identificazione vengono compilati nel modo seguente:
- Se DbgHelp cerca un file con estensione pdb, il parametro ID specifica la firma PDB, come indicato nella directory di debug codeview dell'immagine originale. Il parametro due specifica l'età PDB. Il parametro tre è inutilizzato e impostato su zero.
- Se DbgHelp cerca qualsiasi altro tipo di immagine, ad esempio un file eseguibile o un file con estensione dbg, il parametro id specifica il TimeDateStamp dell'immagine originale, come indicato nell'intestazione PE. Il parametro due specifica il campo SizeOfImage, estratto anche dall'intestazione PE. Il parametro tre è inutilizzato e impostato su zero.
Durante la ricerca in una directory, questa funzione non verifica che gli identificatori dei simboli corrispondano per impostazione predefinita. Per assicurarsi che i file di simboli corrispondenti si trovino, chiamare la funzione
Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione genereranno probabilmente 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.
Nota
L'intestazione dbghelp.h definisce SymFindFileInPath come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
Requisito | Valore |
---|---|
piattaforma di destinazione | Finestre |
intestazione |
dbghelp.h |
libreria |
DbgHelp.lib |
dll | DbgHelp.dll |
Ridistribuibile | DbgHelp.dll 5.1 o versione successiva |