ConfigSnapshotByPIDEx
Configure instantané à l’aide de l’ID de processus fourni.
Syntaxe
HRESULT ConfigSnapshotByPIDEx
([in] SnapshotType snapshotType,
[in, out] ULONG* pids,
[in, out] HRESULT* pResults,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
Paramètres
snapshotType
[in] SnapshotType.
Remarque : Actuellement, seul SnapshotType disponible est SnapshotType_Heap
Pids
[in] Pointeur vers un tableau d’ID de processus.
pResults
[in, out] La mémoire tampon allouée par l’utilisateur qui contiendra le code hresult de configuration instantané pour chaque ID de processus spécifié, le tableau transmis dans le deuxième paramètre.
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 de tas des PID. |
Notes
Lorsque la fonction retourne au moins une défaillance partielle (S_FALSE), chaque élément de pResults affiche le résultat de configuration de l’ID de processus correspondant passé dans le deuxième paramètre.
Par exemple, si vous passez 3 pids, le tableau pResults affiche le résultat de configuration de chaque pid, comme indiqué ci-dessous.
| Pids [in] | 0x1086 | 0x98004 | 0x12004 |
| pResults [out] | S_OK | E_INVALIDARG | S_OK |
La configuration instantané est valide jusqu’à ce qu’elle soit explicitement désactivée ou que le processus se termine.