Função QueryWorkingSet (psapi.h)

Recupera informações sobre as páginas atualmente adicionadas ao conjunto de trabalho do processo especificado.

Para recuperar informações do conjunto de trabalho para um subconjunto de endereços virtuais ou para recuperar informações sobre páginas que não fazem parte do conjunto de trabalho (como AWE ou páginas grandes), use a função QueryWorkingSetEx .

Sintaxe

BOOL QueryWorkingSet(
  [in]  HANDLE hProcess,
  [out] PVOID  pv,
  [in]  DWORD  cb
);

Parâmetros

[in] hProcess

Um identificador para o processo. O identificador deve ter os direitos de acesso PROCESS_QUERY_INFORMATION e PROCESS_VM_READ . Para obter mais informações, consulte Direitos de acesso e segurança do processo.

[out] pv

Um ponteiro para o buffer que recebe as informações. Para obter mais informações, consulte PSAPI_WORKING_SET_INFORMATION.

Se o buffer apontado pelo parâmetro pv não for grande o suficiente para conter todas as entradas do conjunto de trabalho para o processo de destino, a função falhará com ERROR_BAD_LENGTH. Nesse caso, o membro NumberOfEntries da estrutura PSAPI_WORKING_SET_INFORMATION é definido como o número necessário de entradas, mas a função não retorna informações sobre as entradas do conjunto de trabalho.

[in] cb

O tamanho do buffer pv , em bytes.

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 GetLastError.

Comentários

A partir do Windows 7 e do Windows Server 2008 R2, o Psapi.h estabelece números de versão para as funções PSAPI. O número de versão do PSAPI afeta o nome usado para chamar a função e a biblioteca que um programa deve carregar.

Se PSAPI_VERSION for 2 ou maior, essa função será definida como K32QueryWorkingSet em Psapi.h e exportada em Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION for 1, essa função será definida como QueryWorkingSet em Psapi.h e exportada em Psapi.lib e Psapi.dll como um wrapper que chama K32QueryWorkingSet.

Os programas que devem ser executados em versões anteriores do Windows, bem como no Windows 7 e versões posteriores, sempre devem chamar essa função como QueryWorkingSet. Para garantir a resolução correta de símbolos, adicione Psapi.lib à macro TARGETLIBS e compile o programa com -DPSAPI_VERSION=1. Para usar a vinculação dinâmica em tempo de execução, carregue Psapi.dll.

Requisitos

Confira também

EnumProcesses

Funções PSAPI

PSAPI_WORKING_SET_INFORMATION

QueryWorkingSetEx

Informações do conjunto de trabalho