Share via


CeGetFileNotificationInfo (Windows CE 5.0)

Send Feedback

This function retrieves file notification information.

BOOLCeGetFileNotificationInfo( HANDLEh,DWORD dwFlags,LPVOID lpBuffer,DWORD nBufferLength,LPDWORD lpBytesReturned,LPDWORD lpBytesAvailable);

Parameters

  • h
    [in] Handle returned from FindFirstChangeNotification.
  • dwFlags
    [in] Flag value.
  • 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 Values

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

Remarks

If lpBuffer is set to NULL and nBufferLength is set to zero, then CeGetFileNotificationInfo sets lpBytesAvailable to the current number of bytes available to return.

When CeGetFileNotificationInfo returns, lpBuffer contains a pointer to a FILE_NOTIFY_INFORMATION structure. If more notification data is available when CeGetFileNotificationInfo returns successfully, GetLastError will return ERROR_MORE_DATA. If notifications are available but they do not fit in lpBuffer, GetLastError will return ERROR_INSUFFICIENT_BUFFER.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Winbase.h.
Link Library: Coredll.lib.

See Also

FindFirstChangeNotification | FindNextChangeNotification | FindCloseChangeNotification

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.