FbwfFindFirst

Retrieves information about the first file in the FBWF cache.

  ULONG FbwfFindFirst(
   PWSTR volume,
   PFbwfCacheDetail cacheDetail,
   PULONG size
  );

Parameters

  • volume
    [in] NULL terminated wide string containing the name of the volume.
  • cacheDetail
    [out] Caller allocated buffer containing the first cache detail.
  • size
    [in, out] On input, contains the size of cacheDetail. If the function returns ERROR_MORE_DATA, size will contain the size of the required buffer.

Return Values

This function may return the following:

Return value Description
NO_ERROR The operation completed successfully.
ERROR_INVALID_DRIVE If the specified volume is valid but does not exist or is not protected.
ERROR_INVALID_FUNCTION If the filter is disabled for the current session.
ERROR_INVALID_PARAMETER If volume, cacheDetail, or size is NULL.
ERROR_MORE_DATA If the cacheDetail buffer is too small, in which case size will contain the required buffer size.
ERROR_FILE_NOT_FOUND If the specified volume has no cached files.
ERROR_NOT_ENOUGH_MEMORY If there is not enough memory for allocation of internal FbfwFindFirst/FbfwFindNext buffers.

Requirements

OS Versions: Windows XP Embedded.
Header: fbwfapi.h.
Link Library: fbwflib.lib.

See Also

FBWF API | FbwfFindNext | FbwfFindClose | FbwfCacheDetail

Last updated on Wednesday, October 18, 2006

© 2006 Microsoft Corporation. All rights reserved.