Compartilhar via

Função GetProcessHandleCount (processthreadsapi.h)

  • Artigo

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

Confira também

Funções de thread e processo

Processos