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

Confira também

Funções de thread e processo

Processos