Xceed Zip Compression Library Documentation
SfxBinaryModule property
Xceed Zip control reference > Xceed Zip control properties > SfxBinaryModule property

Description

The SfxBinaryModule property is used to inform the Xceed Zip Compression Library to create self-extracting zip files instead of regular zip files, and to provide the filename and location of the binary to use for creating the self-extracting Zip files.

If you do not specify a path and filename in the SfxBinaryModule property, the Zip method will create a regular zip file. If you specify a path and filename, the library will create a self-extracting zip file.

Because Xceed's self-extracting binary modules support Zip64, they can create self-extracting files larger than 2 GB. However, the Windows operating system usually has difficulty loading executables this large. It is therefore recommended to limit the size of self-extracting files to 2 GB.

You can use the binaries provided with the Xceed Zip Self-Extractor Module or any 3rd party binary such as the Info-Zip group's free SFX binary. Only the binaries provided with the Xceed Zip Self-Extractor Module are configurable. These binaries are as follows:

SFX Module Description
XCDSFX16.BIN For 16-bit self-extracting zip files that work on Windows 3.1 and up.
XCDSFX32.BIN For 32-bit self-extracting zip files created with the Deflate method that work on Windows 95 and up.
XCDSFXBZ.BIN For self-extracting zip files created with the BWT method.
XcdSfxZ64BzAES.bin For 32-bit self-extracting zip files created with Deflate, Deflate64, BZip2, BWT, and LZMA compression methods, and encrypted with AES, supporting Zip64 format extensions and extra headers.
XcdSfxZ64AES.bin For 32-bit self-extracting zip files created with Deflate or Deflate64 compression methods and encrypted with AES, supporting Zip64 format extensions and extra headers.
XcdSfxZ64.bin For 32-bit self-extracting zip files created with Deflate or Deflate64 compression methods, supporting Zip64 format extensions and extra headers.
XcdSfxZ64LzmaAES.bin For 32-bit self-extracting zip files created with Deflate, Deflate64, or LZMA compression methods and encrypted with AES, supporting Zip64 format extensions and extra headers.
XcdSfxZ64Lzma.bin For 32-bit self-extracting zip files created with Deflate, Deflate64, or LZMA compression methods, supporting Zip64 format extensions and extra headers.

Note for Windows Vista users

In order for your self-extracting zip file to work properly under Windows Vista, one of the following SFX modules which have been compiled with the appropriate manifests must be used. 

SFX Module Description
xcdsfx32_requireAdministrator.bin
xcdsfxbz_requireAdministrator.bin
XcdSfxZ64BzAES_requireAdministrator.bin
XcdSfxZ64AES_requireAdministrator.bin
XcdSfxZ64_requireAdministrator.bin
XcdSfxZ64LzmaAES_requireAdministrator.bin
XcdSfxZ64Lzma_requireAdministrator.bin
Requires administrative privileges in order to run.
xcdsfx32_highestAvailable.bin
xcdsfxbz_highestAvailable.bin
XcdSfxZ64BzAES_highestAvailable.bin
XcdSfxZ64AES_highestAvailable.bin
XcdSfxZ64_highestAvailable.bin
XcdSfxZ64LzmaAES_highestAvailable.bin
XcdSfxZ64Lzma_highestAvailable.bin
Requires highest available privileges in order to run.
xcdsfx32_asInvoker.bin
xcdsfxbz_asInvoker.bin
XcdSfxZ64BzAES_asInvoker.bin
XcdSfxZ64AES_asInvoker.bin
XcdSfxZ64_asInvoker.bin
XcdSfxZ64LzmaAES_asInvoker.bin
XcdSfxZ64Lzma_asInvoker.bin
Requires invoker privileges in order to run.

All the manifests used by the above SFX modules have their requestedExecution attribute level set to the corresponding value, and the UIAccess attribute set to false. Select the one which bests suits the target platform.

For more information can be found on the Understanding and Configuring User Account Control in Windows Vista web site.

Data type

String

Default value

Empty (Create regular zip files, not self-extracting zip files)

Declaration (DLL API)  

UINT XzGetSfxBinaryModule( HXCEEDZIP hZip, TCHAR* pszBuffer, UINT uMaxLength )
void XzSetSfxBinaryModule( HXCEEDZIP hZip, const TCHAR* pszValue )

Applicable methods

Zip, Convert

Related topics

None