Função GetProcessInformation (processthreadsapi.h)

Artigo
07/21/2023

Recupera informações sobre o processo especificado.

Sintaxe

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

Parâmetros

[in] hProcess

Um identificador para o processo. Esse identificador deve ter pelo menos o direito de acesso PROCESS_QUERY_LIMITED_INFORMATION . Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.

[in] ProcessInformationClass

Um membro da enumeração PROCESS_INFORMATION_CLASS especificando o tipo de informação a ser recuperada.

ProcessInformation

Ponteiro para um objeto para receber o tipo de informação especificado pelo parâmetro ProcessInformationClass .

Se o parâmetro ProcessInformationClass for ProcessMemoryPriority, esse parâmetro deverá apontar para uma estrutura MEMORY_PRIORITY_INFORMATION.

Se o parâmetro ProcessInformationClass for ProcessPowerThrottling, esse parâmetro deverá apontar para uma estrutura PROCESS_POWER_THROTTLING_STATE.

Se o parâmetro ProcessInformationClass for ProcessProtectionLevelInfo, esse parâmetro deverá apontar para uma estrutura PROCESS_PROTECTION_LEVEL_INFORMATION.

Se o parâmetro ProcessInformationClass for ProcessLeapSecondInfo, esse parâmetro deverá apontar para uma estrutura PROCESS_LEAP_SECOND_INFO.

Se o parâmetro ProcessInformationClass for ProcessAppMemoryInfo, esse parâmetro deverá apontar para uma estrutura APP_MEMORY_INFORMATION.

Se o parâmetro ProcessInformationClass for ProcessMaxOverridePrefetchParameter, esse parâmetro deverá apontar para uma estrutura OVERRIDE_PREFETCH_PARAMETER.

[in] ProcessInformationSize

O tamanho em bytes da estrutura especificada pelo parâmetro ProcessInformation .

Se o parâmetro ProcessInformationClass for ProcessMemoryPriority, esse parâmetro deverá ser sizeof(MEMORY_PRIORITY_INFORMATION).

Se o parâmetro ProcessInformationClass for ProcessPowerThrottling, esse parâmetro deverá ser sizeof(PROCESS_POWER_THROTTLING_STATE).

Se o parâmetro ProcessInformationClass for ProcessProtectionLevelInfo, esse parâmetro deverá ser sizeof(PROCESS_PROTECTION_LEVEL_INFORMATION).

Se o parâmetro ProcessInformationClass for ProcessLeapSecondInfo, esse parâmetro deverá ser sizeof(PROCESS_LEAP_SECOND_INFO).

Se o parâmetro ProcessInformationClass for ProcessAppMemoryInfo, esse parâmetro deverá ser sizeof(APP_MEMORY_INFORMATION).

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame a função GetLastError.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	processthreadsapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

Função GetThreadInformation, estrutura MEMORY_PRIORITY_INFORMATION, função SetProcessInformation , enumeração PROCESS_INFORMATION_CLASS , estrutura OVERRIDE_PREFETCH_PARAMETER

Compartilhar via