Share via

Función GetProcessHandleCount (processthreadsapi.h)

  • Artículo

Recupera el número de identificadores abiertos que pertenecen al proceso especificado.

Sintaxis

BOOL GetProcessHandleCount(
  [in]      HANDLE hProcess,
  [in, out] PDWORD pdwHandleCount
);

Parámetros

[in] hProcess

Identificador del proceso cuyo recuento de identificadores se solicita. El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

Windows Server 2003 y Windows XP: El identificador debe tener el derecho de acceso PROCESS_QUERY_INFORMATION.

[in, out] pdwHandleCount

Puntero a una variable que recibe el número de identificadores abiertos que pertenecen al proceso especificado.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función recupera información sobre los objetos ejecutivos para el proceso. Para obtener más información, vea Objetos de kernel.

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0501 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado processthreadsapi.h (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de proceso y subproceso

Procesos