Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function obtains file notification information.

Note:
FILE_NOTIFY_CHANGE_CEGETINFO must have been specified in the preceding call to the FindFirstChangeNotificationfunction, or this function returns no data.

Syntax 

BOOL CeGetFileNotificationInfo(
  HANDLE 
h,
  DWORD
 dwFlags,
  LPVOID
 lpBuffer,
  DWORD
 nBufferLength,
  LPDWORD
 lpBytesReturned,
  LPDWORD
 lpBytesAvailable
);

Parameters

h

[in] Handle returned from FindFirstChangeNotification.

dwFlags

Reserved. Set to zero.

lpBuffer

[out] Pointer to a buffer.

nBufferLength

[in] Length of the buffer.

lpBytesReturned

[out] Number of bytes returned.

lpBytesAvailable

[out] Additional change notification information available.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

If lpBufferis set to NULL and nBufferLengthis set to zero, this function sets lpBytesAvailableto the current number of bytes available to return.

When this function returns, lpBuffercontains a pointer to a FILE_NOTIFY_INFORMATIONstructure. If more notification data is available when this function returns successfully, GetLastErrorreturns ERROR_MORE_DATA. If notifications are available but they do not fit in lpBuffer, GetLastErrorreturns ERROR_INSUFFICIENT_BUFFER.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.2 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also