Edit

CSCFindFirstFileW function

  • Article

[This function is not supported and should not be used.]

Searches for a file in the Offline Files cache that meets the specified criteria.

Syntax

HANDLE WINAPI CSCFindFirstFileW(
  _In_  LPCWSTR          lpszFileName,
  _Out_ WIN32_FIND_DATAW *lpFind32,
  _Out_ LPDWORD          lpdwStatus,
  _Out_ LPDWORD          lpdwPinCount,
  _Out_ LPDWORD          lpdwHintFlags,
  _Out_ FILETIME         *lpOrgFileTime
);

Parameters

lpszFileName [in]

A pointer to a null-terminated string that specifies a valid UNC directory or path.

lpFind32 [out]

A pointer to the WIN32_FIND_DATA structure that receives information about the file or subdirectory.

lpdwStatus [out]

An NTSTATUS code that indicates the status of the call.

lpdwPinCount [out]

This parameter is nonzero if the file has been made available offline or 0 otherwise.

lpdwHintFlags [out]

This parameter can be one of the following values.

Value Meaning
FLAG_CSC_HINT_PIN_USER
0x01
 A user has made the file available offline.
FLAG_CSC_HINT_PIN_INHERIT_USER
0x02
 A user has made the parent available offline and marked the parent such that its children are available offline.
FLAG_CSC_HINT_PIN_INHERIT_SYSTEM
0x04
 An administrator or group policy has made the parent available offline and marked the parent such that its children are available offline.
FLAG_CSC_HINT_PIN_SYSTEM
0x10
 An administrator or group policy has made the file available offline.

 

lpOrgFileTime [out]

A pointer to a FILETIME structure to receive the date and time information for the file or subdirectory.

Return value

If the function succeeds, the return value is a search handle used in a subsequent call to CSCFindNextFileW or CSCFindClose.

If the function fails, the return value is INVALID_HANDLE_VALUE.

Remarks

This function has no associated import library or header file; you must call it using the LoadLibrary and GetProcAddress functions.

Requirements

Requirement Value
DLL
Cscmig.dll