Edit

FILEPATHS_SIGNERINFO_A structure (setupapi.h)

  • Article

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

Syntax

typedef struct _FILEPATHS_SIGNERINFO_A {
  PCSTR Target;
  PCSTR Source;
  UINT  Win32Error;
  DWORD Flags;
  PCSTR DigitalSigner;
  PCSTR Version;
  PCSTR CatalogFile;
} FILEPATHS_SIGNERINFO_A, *PFILEPATHS_SIGNERINFO_A;

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_SIGNERINFO 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.

DigitalSigner

Digital signer of the file.

Version

Version of the file.

CatalogFile

Catalog file.

Remarks

Note

The setupapi.h header defines FILEPATHS_SIGNERINFO 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