Função InitializeProcessForWsWatch (psapi.h)

Inicia o monitoramento do conjunto de trabalho do processo especificado. Você deve chamar essa função antes de chamar a função GetWsChanges .

Sintaxe

BOOL InitializeProcessForWsWatch(
  [in] HANDLE hProcess
);

Parâmetros

[in] hProcess

Um identificador para o processo. O identificador deve ter o acesso de PROCESS_QUERY_INFORMATION correto. Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.

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 superior, essa função será definida como K32InitializeProcessForWsWatch em Psapi.h e exportada em Kernel32.lib e Kernel32.dll. Se PSAPI_VERSION for 1, essa função será definida como InitializeProcessForWsWatch em Psapi.h e exportada em Psapi.lib e Psapi.dll como um wrapper que chama K32InitializeProcessForWsWatch.

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

GetWsChanges

Funções PSAPI

Informações do conjunto de trabalho