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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | psapi.h |
| Biblioteca | Kernel32.lib no Windows 7 e Windows Server 2008 R2; Psapi.lib (se PSAPI_VERSION=1) no Windows 7 e Windows Server 2008 R2; Psapi.lib no Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP |
| DLL | Kernel32.dll no Windows 7 e no Windows Server 2008 R2; Psapi.dll (se PSAPI_VERSION=1) no Windows 7 e no Windows Server 2008 R2; Psapi.dll no Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP |