Funzione SymAddSymbolW (dbghelp.h)

Aggiunge un simbolo virtuale al modulo specificato.

Sintassi

BOOL IMAGEAPI SymAddSymbolW(
  [in] HANDLE  hProcess,
  [in] ULONG64 BaseOfDll,
  [in] PCWSTR  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.

Nota

L'intestazione dbghelp.h definisce SymAddSymbol come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
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