Función GetProcessInformation (processthreadsapi.h)

  • Artículo

Recupera información sobre el proceso especificado.

Sintaxis

BOOL GetProcessInformation(
  [in] HANDLE                    hProcess,
  [in] PROCESS_INFORMATION_CLASS ProcessInformationClass,
       LPVOID                    ProcessInformation,
  [in] DWORD                     ProcessInformationSize
);

Parámetros

[in] hProcess

Identificador del proceso. Este identificador debe tener al menos el derecho de acceso PROCESS_QUERY_LIMITED_INFORMATION . Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

[in] ProcessInformationClass

Miembro de la enumeración PROCESS_INFORMATION_CLASS que especifica el tipo de información que se va a recuperar.

ProcessInformation

Puntero a un objeto para recibir el tipo de información especificado por el parámetro ProcessInformationClass .

Si el parámetro ProcessInformationClass es ProcessMemoryPriority, este parámetro debe apuntar a una estructura MEMORY_PRIORITY_INFORMATION.

Si el parámetro ProcessInformationClass es ProcessPowerThrottling, este parámetro debe apuntar a una estructura PROCESS_POWER_THROTTLING_STATE.

Si el parámetro ProcessInformationClass es ProcessProtectionLevelInfo, este parámetro debe apuntar a una estructura PROCESS_PROTECTION_LEVEL_INFORMATION.

Si el parámetro ProcessInformationClass es ProcessLeapSecondInfo, este parámetro debe apuntar a una estructura PROCESS_LEAP_SECOND_INFO.

Si el parámetro ProcessInformationClass es ProcessAppMemoryInfo, este parámetro debe apuntar a una estructura APP_MEMORY_INFORMATION.

Si el parámetro ProcessInformationClass es ProcessMaxOverridePrefetchParameter, este parámetro debe apuntar a una estructura OVERRIDE_PREFETCH_PARAMETER.

[in] ProcessInformationSize

Tamaño en bytes de la estructura especificada por el parámetro ProcessInformation .

Si el parámetro ProcessInformationClass es ProcessMemoryPriority, este parámetro debe ser sizeof(MEMORY_PRIORITY_INFORMATION).

Si el parámetro ProcessInformationClass es ProcessPowerThrottling, este parámetro debe ser sizeof(PROCESS_POWER_THROTTLING_STATE).

Si el parámetro ProcessInformationClass es ProcessProtectionLevelInfo, este parámetro debe ser sizeof(PROCESS_PROTECTION_LEVEL_INFORMATION).

Si el parámetro ProcessInformationClass es ProcessLeapSecondInfo, este parámetro debe ser sizeof(PROCESS_LEAP_SECOND_INFO).

Si el parámetro ProcessInformationClass es ProcessAppMemoryInfo, este parámetro debe ser sizeof(APP_MEMORY_INFORMATION).

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a la función GetLastError.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado processthreadsapi.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Función GetThreadInformation, estructura MEMORY_PRIORITY_INFORMATION, función SetProcessInformation, enumeración PROCESS_INFORMATION_CLASS, estructura de OVERRIDE_PREFETCH_PARAMETER