Export (0) Print
Expand All

FbwfFindFirstEx

3/21/2011

This function returns the first entry of the files and folders that are currently cached by the write filter. The caller provides a volume path and the buffer to hold cache detail with its size specified in CacheDetailSize.

When the function succeeds, the function updates the value pointed by this parameter to the size of CacheDetail.

When the buffer is too small ERROR_INSUFFICIENT_BUFFER is returned and the value pointed by CacheDetailSize is updated to the size required to hold the first entry.

If the function succeeds, the return value is a search handle that is used in a later call to FbwfFindNextEx or FbwfFindCloseEx, and the CacheDetail parameter contains information about the first file or directory found.

If the function fails because no files are in the overlay, it returns ERROR_NO_MORE_FILES.

ULONG WINAPI FbwfFindFirstEx(
   __in LPCWSTR VolumeName,
   __out_bcount(*CacheDetailSize) PFbwfCacheDetailEx CacheDetail,
   __inout PULONG CacheDetailSize,
   __out FBWF_FIND_FILE_HANDLE *FindHandle
);

VolumeName

[in] Null-terminated wide string that contains the name of the volume.

CacheDetail

[out] Caller allocated buffer that contains the first cache detail.

CacheDetailSize

[in, out] On input, contains the size of CacheDetail. If the function returns ERROR_MORE_DATA, size contains the size in bytes of the required buffer.

FindHandle

[out] The search handle returned by the function.

This function may return the following:

Return value Description

ERROR_SUCCESS

The operation completed successfully.

ERROR_INSUFFICIENT_BUFFER

If the buffer is too small.

ERROR_NO_MORE_FILES

If there are no files are in the overlay.

OS Versions: Standard 7

Header: Fbwfapi.h

Link Library: Fbwflib.lib

Show:
© 2014 Microsoft