Méthode IDebugClient4 ::StartProcessServer (dbgeng.h)

Article
02/23/2024

La méthode StartProcessServer démarre un serveur de processus.

Syntaxe

HRESULT StartProcessServer(
  [in]           ULONG Flags,
  [in]           PCSTR Options,
  [in, optional] PVOID Reserved
);

Paramètres

[in] Flags

Spécifie la classe des cibles qui seront disponibles via le serveur de processus. Ce paramètre doit être défini sur DEBUG_CLASS_USER_WINDOWS.

[in] Options

Spécifie les options de connexion pour ce serveur de processus. Il s’agit des mêmes options que celles fournies à l’option -t de la ligne de commande DbgSrv. Pour plus d’informations sur la syntaxe de cette chaîne, consultez Activation d’un serveur de processus.

[in, optional] Reserved

Défini sur NULL.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Le serveur de processus démarré est accessible par les clients distants via le transport spécifié dans le paramètre Options .

Pour arrêter le serveur de processus à partir du client intelligent, utilisez la méthode EndProcessServer . Pour arrêter le serveur de processus de l’ordinateur sur lequel il s’exécute, utilisez le Gestionnaire des tâches pour mettre fin au processus. Si le instance du moteur de débogueur qui a utilisé StartProcessServer est toujours en cours d’exécution, il peut utiliser Execute pour émettre la commande de débogueur .endsrv 0, qui met fin au serveur de processus (il s’agit d’une exception au comportement habituel de .endsrv, qui n’affecte généralement pas les serveurs de processus).

Pour plus d’informations sur les serveurs de processus et le débogage à distance, consultez Serveurs de processus, Serveurs de connexion du noyau et Clients intelligents.