Méthode IDebugSystemObjects4 ::SetCurrentProcessId (dbgeng.h)

Article
02/23/2024

La méthode SetCurrentProcessId fait du processus spécifié le processus en cours.

Syntaxe

HRESULT SetCurrentProcessId(
  [in] ULONG Id
);

Paramètres

[in] Id

Spécifie l’ID de processus du moteur pour le processus qui doit devenir le processus actuel.

Valeur retournée

Cette méthode peut également retourner d’autres valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La méthode a réussi.
E_NOINTERFACE	Aucun processus avec l’ID de processus donné n’a été trouvé.
E_FAIL	Aucun candidat approprié pour le thread actuel n’a pu être trouvé dans le processus.

Remarques

Cette méthode modifie également le thread actuel et peut modifier la cible actuelle et l’ordinateur actuel.

Si le processus est modifié, le rappel IDebugEventCallbacks ::ChangeEngineState est appelé avec le DEBUG_CES_CURRENT_THREAD défini.

Note Dans le débogage en mode noyau, le processus actuel est un processus virtuel, ce n’est pas un processus système. Cette méthode ne peut pas être utilisée pour passer d’un processus système à l’autre dans le débogage en mode noyau. Toutefois, le processus implicite peut être modifié à l’aide de SetImplicitProcessDataOffset.

Pour plus d’informations sur les processus, consultez Threads et processus. Pour plus d’informations sur la surveillance des événements, consultez Surveillance des événements.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)