[pywin32-checkins] pywin32/win32/src win32file.i,1.43,1.44

[Mark H. <mha...@us...>]

Update of /cvsroot/pywin32/pywin32/win32/src
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17872

Modified Files:
	win32file.i 
Log Message:
CreateIoCompletionPort returns a handle object so it gets automatically
closed (and a .Close() method).
Autoduck clarifications.


Index: win32file.i
===================================================================
RCS file: /cvsroot/pywin32/pywin32/win32/src/win32file.i,v
retrieving revision 1.43
retrieving revision 1.44
diff -C2 -d -r1.43 -r1.44
*** win32file.i	1 Sep 2004 05:09:38 -0000	1.43
--- win32file.i	6 Sep 2004 23:49:18 -0000	1.44
***************
*** 227,231 ****
  #ifndef MS_WINCE
  // @pyswig <o PyHANDLE>|CreateIoCompletionPort|Can associate an instance of an opened file with a newly created or an existing input/output (I/O) completion port; or it can create an I/O completion port without associating it with a file.
! HANDLE CreateIoCompletionPort (
    HANDLE FileHandle,              // @pyparm <o PyHANDLE>|handle||file handle to associate with the I/O completion port
    HANDLE INPUT_NULLOK,  // @pyparm <o PyHANDLE>|existing||handle to the I/O completion port
--- 227,231 ----
  #ifndef MS_WINCE
  // @pyswig <o PyHANDLE>|CreateIoCompletionPort|Can associate an instance of an opened file with a newly created or an existing input/output (I/O) completion port; or it can create an I/O completion port without associating it with a file.
! PyHANDLE CreateIoCompletionPort (
    HANDLE FileHandle,              // @pyparm <o PyHANDLE>|handle||file handle to associate with the I/O completion port
    HANDLE INPUT_NULLOK,  // @pyparm <o PyHANDLE>|existing||handle to the I/O completion port
***************
*** 1536,1539 ****
--- 1536,1545 ----
  	}
  	ret = PyObject_FromFILE_NOTIFY_INFORMATION(buffer, bytes_returned);
+     // @rdesc The result is a list of (action, filename)
+     // @comm The FILE_NOTIFY_INFORMATION structure used by this function
+     // is variable length, depending on the length of the filename.
+     // The size of the buffer must be at least 6 bytes long + the length
+     // of the filenames returned.  The number of notifications that can be
+     // returned for a given buffer size depends on the filename lengths.
  done:
  	free(buffer);