Partager via


ConfigSnapshotByPID

Configure instantané à l’aide de l’ID de processus fourni.

Syntaxe

HRESULT ConfigSnapshotByPID
([in, out] ULONG* pids,
 [in] ULONG cPids,
[in] VARIANT_BOOL fEnable);

Paramètres

Pids
[in] Pointeur vers un tableau d’ID de processus.
cPids
[in] Nombre d’ID de processus dans le tableau.
fEnable
[in] Valeur booléenne qui indique s’il faut activer ou désactiver le instantané.

Valeur de retour

Le tableau suivant décrit les valeurs de retour possibles.

Valeur de retour Description
S_OK La configuration a réussi pour les processus spécifiés.
S_FALSE La configuration a été partiellement réussie. Reportez-vous à pResults pour examiner plus en détail quel processus a échoué.
E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS Échec de la configuration du contrôle de la pile du tas du ou des PID.

Notes

Lorsque la fonction retourne une défaillance partielle (S_FALSE), cela signifie que tous les processus du tableau d’ID de processus ne sont pas correctement configurés. Pour déterminer le ou les processus qui ont échoué, utilisez la fonction ConfigSnapshotByPIDEx .

La configuration instantané est valide jusqu’à ce qu’elle soit explicitement désactivée ou que le processus se termine.