Condividi tramite


Funzione SymGetTypeFromNameW (dbghelp.h)

Recupera un indice di tipo per il nome del tipo specificato.

Sintassi

BOOL IMAGEAPI SymGetTypeFromNameW(
  [in]      HANDLE        hProcess,
  [in]      ULONG64       BaseOfDll,
  [in]      PCWSTR        Name,
  [in, out] PSYMBOL_INFOW Symbol
);

Parametri

[in] hProcess

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

[in] BaseOfDll

Indirizzo di base del modulo.

[in] Name

Nome del tipo.

[in, out] Symbol

Puntatore a una struttura SYMBOL_INFO. Il membro TypeIndex contiene l'indice del tipo.

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 recuperare informazioni sul tipo, passare l'indice del tipo alla funzione SymGetTypeInfo.

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 SymGetTypeFromName 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

Vedere anche

DbgHelp Functions

SYMBOL_INFO

SymGetTypeInfo