Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function searches for a file or subdirectory in a directory on a remote Windows Embedded CE–based device.

Syntax 

HANDLE CeFindFirstFile(
  LPCWSTR 
lpFileName, 
  LPCE_FIND_DATA 
lpFindFileData 
);

Parameters

lpFileName

[in] Long pointer to a null-terminated string that specifies a valid directory or path and file name, which can contain wildcard characters (* and ?).

There is a default string size limit for paths of MAX_PATH characters.

lpFindFileData

[out] Long pointer to the CE_FIND_DATAstructure that receives information about the found file or subdirectory.

Return Value

A valid search handle indicates success. INVALID_HANDLE_VALUEindicates failure. The returned handle can be used in subsequent calls to CeFindNextFileor CeFindClose. To get extended error information, call CeGetLastErrorand CeRapiGetError.

Requirements

Header rapi.h
Library rapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also