FbwfFindFirst

5/10/2007

Retrieves information about the first file in the FBWF cache.

Syntax

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 Value

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 FbwfFindFirst/FbwfFindNext buffers.

Requirements

OS Versions: Windows XP Embedded, WEPOS.

Header: fbwfapi.h.

Link Library: fbwflib.lib.

See Also

Reference

FbwfFindNext
FbwfFindClose
FbwfCacheDetail

Concepts

FBWF API