Função GetProcessHandleCount (processthreadsapi.h)
Recupera o número de identificadores abertos que pertencem ao processo especificado.
Sintaxe
BOOL GetProcessHandleCount(
[in] HANDLE hProcess,
[in, out] PDWORD pdwHandleCount
);
Parâmetros
[in] hProcess
Um identificador para o processo cuja contagem de identificadores está sendo solicitada. O identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Para obter mais informações, consulte Direitos de acesso e segurança do processo.
Windows Server 2003 e Windows XP: O identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION.
[in, out] pdwHandleCount
Um ponteiro para uma variável que recebe o número de identificadores abertos que pertencem ao processo especificado.
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
Essa função recupera informações sobre os objetos executivos do processo. Para obter mais informações, consulte Objetos Kernel.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0501 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP1 [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 | processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |