Funzione SymAddSymbol (dbghelp.h)

Aggiunge un simbolo virtuale al modulo specificato.

Sintassi

BOOL IMAGEAPI SymAddSymbol(
  [in] HANDLE  hProcess,
  [in] ULONG64 BaseOfDll,
  [in] PCSTR   Name,
  [in] DWORD64 Address,
  [in] DWORD   Size,
  [in] DWORD   Flags
);

Parametri

[in] hProcess

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

[in] BaseOfDll

Indirizzo di base del modulo.

[in] Name

Nome del simbolo. La dimensione massima di un nome simbolo è MAX_SYM_NAME caratteri.

[in] Address

Indirizzo del simbolo. Questo indirizzo deve essere compreso nell'intervallo di indirizzi del modulo specificato.

[in] Size

Dimensioni del simbolo, in byte. Questo parametro è facoltativo e,

[in] Flags

Questo parametro è inutilizzato.

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

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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.0 o versione successiva

Vedi anche

Funzioni DbgHelp

SymDeleteSymbol