Condividi tramite


Metodo IDebugSymbols3::GetModuleByModuleName (dbgeng.h)

Il metodo GetModuleByModuleName cerca nei moduli di destinazione uno con il nome specificato.

Sintassi

HRESULT GetModuleByModuleName(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parametri

[in] Name

Specifica il nome del modulo desiderato.

[in] StartIndex

Specifica l'indice da cui iniziare la ricerca.

[out, optional] Index

Riceve l'indice del primo modulo con il nome Nome. Se Index è null, queste informazioni non vengono restituite.

[out, optional] Base

Riceve il percorso nello spazio indirizzi di memoria della destinazione della base del modulo. Se base è null, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire altri valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito Descrizione
S_OK
Il metodo ha avuto esito positivo.
E_INVALIDARG
Uno degli argomenti passati non è valido.

Osservazioni

A partire dall'indice specificato, questi metodi restituiscono il primo modulo trovato con il nome specificato. Se la destinazione ha più di un modulo con questo nome, i moduli successivi possono essere trovati tramite chiamate ripetute a questi metodi con valori più elevati di StartIndex.

Per altre informazioni sui moduli, vedere Modules.

Fabbisogno

Requisito Valore
piattaforma di destinazione Desktop
intestazione dbgeng.h (include Dbgeng.h)

Vedere anche

GetModuleByModuleName2

IDebugSymbols

IDebugSymbols2

IDebugSymbols3