FILEPATHS_W structure (setupapi.h)

The FILEPATHS structure stores source and target path information. The setup functions send the FILEPATHS structure as a parameter in several of the notifications sent to callback routines. For more information, see Notifications.

Syntax

typedef struct _FILEPATHS_W {
  PCWSTR Target;
  PCWSTR Source;
  UINT   Win32Error;
  DWORD  Flags;
} FILEPATHS_W, *PFILEPATHS_W;

Members

Target

Path to the target file.

Source

Path to the source file. This member is not used when the FILEPATHS structure is used with a file delete operation.

Win32Error

If an error occurs, this member is the system error code. If no error has occurred, it is NO_ERROR.

Flags

Additional information that depends on the notification sent with the FILEPATHS structure.

For SPFILENOTIFY_COPYERROR notifications, Flags specifies dialog box behavior and can be one of the following values.

Value Meaning
SP_COPY_NOBROWSE
Do not offer the user the option to browse.
SP_COPY_NOSKIP
Do not offer the user the option to skip the file.
SP_COPY_WARNIFSKIP
Inform the user that skipping the file may affect the installation.
 

For SPFILENOTIFY_FILEOPDELAYED notifications, Flags specifies the type of file operation delayed and can be one of the following values.

Value Meaning
FILEOP_COPY
A file copy operation was delayed.
FILEOP_DELETE
A file delete operation was delayed.

Remarks

Note

The setupapi.h header defines FILEPATHS as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header setupapi.h

See also

Overview

Structures