Windows API Guide: BM_SETCHECK Message


Declare Function CloseHandle Lib "kernel32.dll" (ByVal hObject As Long) As Long

Platforms

  • Windows 95: Supported.
  • Windows 98: Supported.
  • Windows NT: Requires Windows NT 3.1 or later.
  • Windows 2000: Supported.
  • Windows CE: Requires Windows CE 1.0 or later.

Description & Usage

CloseHandle closes a handle and the object associated with that handle. After being closed, the handle is of course no longer valid. This function closes handles associated with access tokens, communications devices, console inputs, console screen buffers, events, files, file mappings, jobs, mailslots, mutexes, named pipes, processes, semaphores, sockets, and threads.

Return Value

If an error occured, the function returns 0 (use GetLastError to get the error code). If successful, the function returns a non-zero value.

Visual Basic-Specific Issues

None.

Parameters

hObject
A handle to the object to close.

Example

' This code is licensed according to the terms and conditions listed here. ' Display the date on which the file C:\MyApp\test.txt was ' created.  Note how the time zone conversion is necessary. Dim hFile As Long  ' handle to the opened file Dim ctime As FILETIME  ' receives time of creation Dim atime As FILETIME  ' receives time of last access Dim mtime As FILETIME  ' receives time of last modification Dim thetime As SYSTEMTIME  ' used to manipulate the time Dim retval As Long  ' return value ' First, open the file C:\MyApp\test.txt for read-level access.  Note the ' expression necessary to pass 0 as lpSecurityAttributes. hFile = CreateFile("C:\MyApp\test.txt", GENERIC_READ, FILE_SHARE_READ, ByVal CLng(0), OPEN_EXISTING, FILE_ATTRIBUTE_ARCHIVE, 0) If hFile = -1 Then   Debug.Print "Could not open the file successfully -- aborting."   End  ' terminate the program End If ' Next, get the creation, last-access, and last-modification times. retval = GetFileTime(hFile, ctime, atime, mtime) ' Convert the creation time to the local time zone. retval = FileTimeToLocalFileTime(ctime, ctime) ' Convert the FILETIME format to the SYSTEMTIME format. retval = FileTimeToSystemTime(ctime, thetime) ' Display the date of creation of the file to the user. Debug.Print "The file was created on "; thetime.wMonth; "-"; thetime.wDay; "-"; thetime.wYear ' Close the file to free up resources. retval = CloseHandle(hFile)

Category

Handles

Go back to the alphabetical Function listing.
Go back to the Reference section index.


Last Modified: October 1, 1999
This page is copyright © 1999 Paul Kuliniewicz. Copyright Information Revised October 29, 2000
Go back to the Windows API Guide home page.
E-mail: vbapi@vbapi.com Send Encrypted E-Mail
This page is at http://www.vbapi.com/ref/c/closehandle.html



Windows API Guide
Windows API Guide - Reference - Volume 1: Version 3.0 For the MS-DOS and PC-DOS Operating Systems
ISBN: B001V0KQIY
EAN: N/A
Year: 1998
Pages: 610

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net