ConfigSnapshotByPIDEx
Configura la instantánea mediante el identificador de proceso proporcionado.
Sintaxis
HRESULT ConfigSnapshotByPIDEx
([in] SnapshotType snapshotType,
[in, out] ULONG* pids,
[in, out] HRESULT* pResults,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
Parámetros
snapshotType
[in] SnapshotType.
Nota : Actualmente solo está disponible SnapshotType SnapshotType_Heap
Pid
[in] Puntero a una matriz de identificadores de proceso.
pResults
[dentro, fuera] El búfer asignado por el usuario que contendrá el código hresult de configuración de instantáneas para cada identificador de proceso especificado, la matriz pasada en el segundo parámetro.
cPids
[in] Número de identificadores de proceso de la matriz.
fEnable
[in] Valor booleano que indica si se va a habilitar o deshabilitar la instantánea.
Valor devuelto
En la tabla siguiente se describen los posibles valores devueltos.
| Valor devuelto | Descripción |
|---|---|
| S_OK | La configuración se realizó correctamente para los procesos especificados. |
| S_FALSE | La configuración se realizó correctamente parcialmente. Consulte pResults para investigar aún más qué proceso no se pudo realizar. |
| E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS | No se pudo configurar el control de pila del montón de PID. |
Comentarios
Cuando la función devuelve al menos un error parcial (S_FALSE), cada elemento de pResults muestra el resultado de configuración del identificador de proceso correspondiente pasado en el segundo parámetro.
Por ejemplo, si pasa 3 pids, la matriz pResults mostrará el resultado de configuración de cada pid como se muestra a continuación.
| Pids [in] | 0x1086 | 0x98004 | 0x12004 |
| pResults [out] | S_OK | E_INVALIDARG | S_OK |
La configuración de instantánea es válida hasta que se deshabilita explícitamente o se cierra el proceso.