SPFILENOTIFY_FILEINCABINET message

The SPFILENOTIFY_FILEINCABINET notification is sent to a callback routine by SetupIterateCabinet for each file found in the cabinet. The callback routine must return a value indicating whether to extract the file.

SPFILENOTIFY_FILEINCABINET
  Param1 = (UINT) FileInCabinetInfo;
  Param2 = (UINT) CabinetFile;
            

Parameters

Param1

Pointer to a FILE_IN_CABINET_INFO structure that contains information about the file in the cabinet.

Param2

Pointer to a null-terminated string that contains the filename of the cabinet file.

Return value

Your callback routine should return one of the following.

Return code Description
FILEOP_SKIP
Do not extract the file, skip it.
FILEOP_DOIT
Extract the file.

If your callback routine returns FILEOP_DOIT, the name to use for the extracted file should be specified in the FullTargetName member of the FILE_IN_CABINET_INFO structure passed to the routine in Param1.

Note

There is no default cabinet callback routine. The setup application should supply a callback routine to handle the notifications sent by SetupIterateCabinet.

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

Notifications

FILE_IN_CABINET_INFO

SetupIterateCabinet