winbase.h


CloseHandle

Cierra un manipulador abierto a un objeto.

Sintaxis

BOOL CloseHandle(
    HANDLE hObject  // manipulador de objeto a cerrar
   );

Parámetros:

hObject: identifica un manipulador de objeto abierto.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener mayor información sobre el error, llamar a GetLastError.

Observaciones

La función CloseHandle cierra manipuladores a los siguientes tipos de objeto:

  • Entrada o salida a consola.
  • Fichero de eventos.
  • File mapping.
  • Mutex.
  • Tubería con nombre.
  • Proceso.
  • Semáforo.
  • Hilo.

CloseHandle invalida el manipulador de objeto especificado, decrementa el contador de manipuladores del objeto y realiza una comprobación del objeto. Una vez que el último manipulador del objeto ha sido cerrado, el objeto se elimina del sistema operativo.

Esta función no cierra objetos módulo.

CloseHandle se usa para cerrar manipuladores devueltos por llamadas a la función CreateFile.