Share via


FbwfFindFirst (Standard 7 SP1)

7/8/2014

Deprecated. Use FbwfFindFirstEx instead.

This function retrieves information about the first file in the FBWF cache.

Syntax

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

Parameters

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

Return Value

This function may return the following:

Return value

Description

ERROR_SUCCESS

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, size contains the required buffer size.

ERROR_FILE_NOT_FOUND

If the specified volume has no cached files.

ERROR_NOT_ENOUGH_MEMORY

If there is insufficient memory for allocation of internal FbwfFindFirst/FbwfFindNext buffers.

Requirements

OS Versions: Standard 7

Header: Fbwfapi.h

Link Library: Fbwflib.lib

See Also

Reference

FbwfFindNext
FbwfFindClose
FbwfCacheDetail

Concepts

FBWF API