ConfigSnapshotByPID
Configura la instantánea mediante el identificador de proceso proporcionado.
Sintaxis
HRESULT ConfigSnapshotByPID
([in, out] ULONG* pids,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
Parámetros
Pid
[in] Puntero a una matriz de identificadores de proceso.
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 valores devueltos posibles.
| 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 ha producido un error. |
| 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 un error parcial (S_FALSE), significa que no todos los procesos de la matriz de identificadores de proceso se configuran correctamente. Para encontrar los procesos con errores, use la función ConfigSnapshotByPIDEx .
La configuración de instantánea es válida hasta que se deshabilita explícitamente o se cierra el proceso.