FSDMGR_CreateSearchHandle

  • Article

This function creates search, or find, handles. It is called by a file system driver (FSD).

HANDLE FSDMGR_CreateSearchHandle( 
HVOL hVol, 
HANDLE hProc,
PSEARCH pSearch);

Parameters

  • hVol
    [in] Handle to the mounted volume that is returned from FSDMGR_RegisterVolume. This handle is not a true Win32 handle.
  • hProc
    [in] Handle to the originating process handle.
  • pSearch
    [out] Pointer to the search-specific data defined by the file system driver for the new handle.

Return Values

A search handle associated with the originating process indicates success. INVALID_HANDLE_VALUE indicates failure.

Remarks

An FSD calls this function when an application calls FindFirstFile and it gets routed to the MyFSD_FindFirstFileW function in the FSD. The handle created by this function is necessary in order to provide proper routing of calls based on the search handle.

This function returns a handle to the application that called the FindFirstFile function created by the independent software vendor.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.10 and later Fsdmgr.h   Fsdmgr.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

FindFirstFile, FSDMGR_RegisterVolume, MyFSD_FindFirstFileW

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.