Condividi tramite

Funzione SymGetSymbolFileW (dbghelp.h)

Individua un file di simboli nel percorso del simbolo specificato.

Sintassi

BOOL IMAGEAPI SymGetSymbolFileW(
  [in, optional] HANDLE hProcess,
  [in, optional] PCWSTR SymPath,
  [in]           PCWSTR ImageFile,
  [in]           DWORD  Type,
  [out]          PWSTR  SymbolFile,
  [in]           size_t cSymbolFile,
  [out]          PWSTR  DbgFile,
  [in]           size_t cDbgFile
);

Parametri

[in, optional] hProcess

Handle per il processo passato originariamente alla funzione SymInitialize.

Se questo handle è 0, SymPath non può essere NULL. Usare questa opzione per caricare un file di simboli senza chiamare SymInitialize o SymCleanup.

[in, optional] SymPath

Percorso del simbolo. Se questo parametro è NULL o una stringa vuota, la funzione usa il percorso del simbolo impostato usando la funzione SymInitialize o SymSetSearchPath.

[in] ImageFile

Nome del file di immagine.

[in] Type

Tipo di file di simboli. Questo parametro può essere uno dei valori seguenti.

Valore Significato
sfImage
0
 File .exe o .dll.
sfDbg
1
 Un file con estensione dbg.
sfPdb
2
 File con estensione pdb.
sfMpd
3
 Riservato.

[out] SymbolFile

Puntatore a una stringa con terminazione Null che riceve il nome del file di simboli.

[in] cSymbolFile

Dimensioni del buffer SymbolFile, in caratteri.

[out] DbgFile

Puntatore a un buffer che riceve il percorso completo del file di simboli. Questo buffer deve essere almeno MAX_PATH caratteri.

[in] cDbgFile

Dimensioni del buffer dbgFile , in caratteri.

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

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 SymGetSymbolFile 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 6.3 o versione successiva

Vedere anche

DbgHelp Functions

SymInitialize

  • Last updated on