FS FINDNOTIFYNEXT: Difference between revisions

Latest revision as of 05:49, 17 February 2020

Resume reporting of changes to a file or directory.

Syntax

FS_FINDNOTIFYNEXT(handle, pData, cbData, pcMatch, level, timeout)

Parameters

handle: is the handle to the find-notify request.; This handle was returned by the FSD and is associated with a previous FS_FINDNOTIFYFIRST or FS_FINDNOTIFYNEXT call.
pData: is the address of the application data area.; Addressing of this data area is not validated by the kernel (see FSH_PROBEBUF). The FSD fills in this area with a set of packed, variable-length structures that contain the requested data and matching file names.
cbData: is the length of the application data area in bytes.
pcMatch: is a pointer to the number of matching entries.; The FSD returns, at most, this number of entries. The FSD returns in this parameter the number of entries actually placed in the data area.; The FSD does not need to verify this pointer.
level: is the information level to be returned.; Level selects among a series of data structures to be returned. See the description of DosFindNotifyFirst in the OS/2 Version 2.0 Control Program Programming Reference for more information.; The level passed to the FSD is valid.
timeout: is the time-out in milliseconds.; The FSD waits until either the time-out has expired, the buffer is full, or the specified number of entries has been returned before returning to the caller.

Calling Sequence

int far pascal FS_FINDNOTIFYNEXT(handle, pData, cbData, pcMatch, level, timeout)

unsigned short handle;
char far * pData;
unsigned short cbData;
unsigned short far * pcMatch;
unsigned short level;
unsigned long timeout;

Remarks

pcMatch is the number of changes required to directories or files that match the pName target and attr specified during a related, previous FS_FINDNOTIFYFIRST. The file system uses this field to return the number of changes that actually occurred since the issue of the present FS_FINDNOTIFYNEXT.

The level passed to FS_FINDNOTIFYNEXT is the same level as that passed to FS_FINDNOTIFYFIRST to initiate the search.

@@ Line 1: / Line 1: @@
-Resume reporting of changes to a file or directory.
+{{DISPLAYTITLE:FS_FINDNOTIFYNEXT}}
+Resume reporting of changes to a file or directory.
 ==Syntax==
   FS_FINDNOTIFYNEXT(handle, pData, cbData, pcMatch, level, timeout)
 ==Parameters==
 ;handle: is the handle to the find-notify request.
-:This handle was returned by the FSD and is associated with a previous FS_ FINDNOTIFYFIRST or FS_FINDNOTIFYNEXT call.
+:This handle was returned by the FSD and is associated with a previous FS_FINDNOTIFYFIRST or FS_FINDNOTIFYNEXT call.
+;pData: is the address of the application data area.
-;pData: is the address of the application data area.
+:Addressing of this data area is not validated by the kernel (see FSH_PROBEBUF). The FSD fills in this area with a set of packed, variable-length structures that contain the requested data and matching file names.
-:Addressing of this data area is not validated by the kernel (see FSH_PROBEBUF ). The FSD fills in this area with a set of packed, variable- length structures that contain the requested data and matching file names.
+;cbData: is the length of the application data area in bytes.
+;pcMatch: is a pointer to the number of matching entries.
-;cbData: is the length of the application data area in bytes.
+:The FSD returns, at most, this number of entries. The FSD returns in this parameter the number of entries actually placed in the data area.
+:The FSD does not need to verify this pointer.
-;pcMatch: is a pointer to the number of matching entries.
+;level: is the information level to be returned.
+:Level selects among a series of data structures to be returned. See the description of DosFindNotifyFirst in the ''OS/2 Version 2.0 Control Program Programming Reference'' for more information.
-:The FSD returns, at most, this number of entries. The FSD returns in this parameter the number of entries actually placed in the data area.
+:The level passed to the FSD is valid.
+;timeout: is the time-out in milliseconds.
-:The FSD does not need to verify this pointer.
+:The FSD waits until either the time-out has expired, the buffer is full, or the specified number of entries has been returned before returning to the caller.
-;level: is the information level to be returned.
-:Level selects among a series of data structures to be returned. See the description of DosFindNotifyFirst in the OS/2 Version 2.0 Control Program Programming Reference for more information.
-:The level passed to the FSD is valid.
-;timeout: is the time-out in milliseconds.
-:The FSD waits until either the time-out has expired, the buffer is full, or the specified number of entries has been returned before returning to the caller .
 ==Calling Sequence ==
 <PRE>
@@ Line 37: / Line 31: @@
 unsigned long timeout;
 </PRE>
 ==Remarks==
-pcMatch is the number of changes required to directories or files that match the pName target and attr specified during a related, previous FS_FINDNOTIFYFIRST . The file system uses this field to return the number of changes that actually occurred since the issue of the present FS_FINDNOTIFYNEXT.
+pcMatch is the number of changes required to directories or files that match the pName target and attr specified during a related, previous FS_FINDNOTIFYFIRST. The file system uses this field to return the number of changes that actually occurred since the issue of the present FS_FINDNOTIFYNEXT.
-The level passed to FS_FINDNOTIFYNEXT is the same level as that passed to FS_ FINDNOTIFYFIRST to initiate the search.
+The level passed to FS_FINDNOTIFYNEXT is the same level as that passed to FS_FINDNOTIFYFIRST to initiate the search.
 [[Category:IFS Interfaces]]
-{{DISPLAYTITLE:FS_FINDNOTIFYNEXT}}