Méthode IDebugHostSymbols ::FindModuleByName (dbgmodel.h)

Article
02/23/2024

La méthode FindModuleByName examine le contexte d’hôte donné et recherche un module qui a le nom spécifié et lui retourne une interface. Il est légal de rechercher le module par nom avec ou sans l’extension de fichier.

Syntaxe

HRESULT FindModuleByName(
  IDebugHostContext *context,
  PCWSTR            moduleName,
  IDebugHostModule  **module
);

Paramètres

context

Ce contexte hôte sera recherché pour un module chargé correspondant au nom donné.

moduleName

Nom du module à rechercher. Le nom peut être spécifié avec ou sans extension de fichier.

module

Si le module est trouvé, une interface vers le module est retournée ici.

Valeur retournée

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

Exemple de Code

ComPtr<IDebugHost> spHost; /* get the host */

ComPtr<IDebugHostSymbols> spSym;
if (SUCCEEDED(spHost.As(&spSym)))
{
    // Find the "notepad.exe" module in the current UI context (process) 
    // of the debug host:
    ComPtr<IDebugHostModule> spModule;
    if (SUCCEEDED(spSym->FindModuleByName(USE_CURRENT_HOST_CONTEXT, 
                                          L"notepad.exe", 
                                          &spModule)))
    {
        // spModule is the module "notepad.exe"
    }
}

Différences dans la correspondance des modules de symboles dans FindModuleByName, CreateTypeSignature et CreateTypeSignatureForModuleRange

FindModuleByName permet au nom du module passé d’être soit le nom réel de l’image du module, par exemple My Module.dll, soit celui par lequel vous pouvez le référencer dans le moteur de débogueur (par exemple, MyModule ou MyModule_<hex_base>).

L’appel de CreateTypeSignatureForModuleRange et le passage d’un nom/nullptr/nullptr crée une signature qui correspond à n’importe quel module correspondant au nom de n’importe quelle version.

Le nom du module passé aux fonctions CreateTypeSignature n’accepte que le nom réel de l’image du module (par exemple, MyModule.dll).

L’appel de FindModuleByName, puis de CreateTypeSignature avec ce module crée une signature qui correspondra uniquement au instance particulier du module qui lui est passé. S’il existe deux copies d’un module chargé (par exemple, ntdll dans un processus 32 bits s’exécutant sur Windows 64 bits), il ne correspondrait qu’à la instance spécifique passée. Elle ne correspondrait plus non plus si cette DLL était déchargée et rechargée. La signature est associée à un instance spécifique d’un module connu par le débogueur.