Funzione SymGetSourceFileW (dbghelp.h)

Articolo
11/20/2024

Recupera il file di origine specificato dal server di origine.

Sintassi

BOOL IMAGEAPI SymGetSourceFileW(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCWSTR  Params,
  [in]           PCWSTR  FileSpec,
  [out]          PWSTR   FilePath,
  [in]           DWORD   Size
);

Parametri

[in] hProcess

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

[in] Base

Indirizzo di base del modulo.

[in, optional] Params

Questo parametro non è usato.

[in] FileSpec

Nome del file di origine.

[out] FilePath

Puntatore a un buffer che riceve il percorso completo del file di origine.

[in] Size

Dimensioni del buffer FilePath, in caratteri.

Valore restituito

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

Se la funzione non riesce, il valore restituito viene FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Osservazioni

Per controllare la directory che riceve i file di origine, usare la funzione SymSetHomeDirectory.

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 SymGetSourceFile 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.2 o versione successiva

Vedere anche

DbgHelp Functions

server di origine

Condividi tramite