PathMatchSpec Function

Searches a string using a Microsoft MS-DOS wild card match type.

Syntax

BOOL PathMatchSpec(      
    LPCTSTR pszFileParam,
    LPCTSTR pszSpec);

Parameters

pszFileParam

• [in] Pointer to a null-terminated string of maximum length MAX_PATH that contains the path to be searched.

pszSpec

• [in] Pointer to a null-terminated string of maximum length MAX_PATH that contains the file type for which to search. For example, to test whether or not pszFileParam is a DOC file, pszSpec should be set to "*.doc".

Return Value

Returns TRUE if the string matches, or FALSE otherwise.

Function Information

Minimum DLL Version	shlwapi.dll version 4.71 or later
Custom Implementation	No
Header	shlwapi.h
Import library	shlwapi.lib
Minimum operating systems	Windows 2000, Windows NT 4.0 with Internet Explorer 4.0, Windows 98, Windows 95 with Internet Explorer 4.0
Unicode	Implemented as ANSI and Unicode versions.

GetCompressedFileSize

The GetCompressedFileSize function retrieves the actual number of bytes of disk storage used to store a specified file. If the file is located on a volume that supports compression and the file is compressed, the value obtained is the compressed size of the specified file. If the file is located on a volume that supports sparse files and the file is a sparse file, the value obtained is the sparse size of the specified file.

DWORD GetCompressedFileSize(
  LPCTSTR lpFileName,
  LPDWORD lpFileSizeHigh);

Parameters

lpFileName

• [in] Pointer to a null-terminated string that specifies the name of the file.

  Do not specify the name of a file on a nonseeking device, such as a pipe or a communications device, as its file size has no meaning.

lpFileSizeHigh

• [out] Pointer to a variable that receives the high-order DWORD of the compressed file size. The function's return value is the low-order DWORD of the compressed file size.

  This parameter can be NULL if the high-order DWORD of the compressed file size is not needed. Files less than 4 gigabytes in size do not need the high-orderDWORD.

Return Values

If the function succeeds, the return value is the low-order DWORD of the actual number of bytes of disk storage used to store the specified file, and iflpFileSizeHigh is non-NULL, the function puts the high-order DWORD of that actual value into theDWORD pointed to by that parameter. This is the compressed file size for compressed files, the actual file size for noncompressed files.

If the function fails, and lpFileSizeHigh is NULL, the return value is INVALID_FILE_SIZE. To get extended error information, callGetLastError.

If the return value is INVALID_FILE_SIZE and lpFileSizeHigh is non-NULL, an application must callGetLastError to determine whether the function has succeeded (value is NO_ERROR) or failed (value is other than NO_ERROR).

Requirements