SdConfirmNewDir

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SdConfirmNewDir function creates a dialog that displays a folder name and prompts for confirmation. If the end user clicks the Yes button, this function creates the new folder automatically.

Syntax

SdConfirmNewDir ( szTitle, szDir, nReserved );

Parameters

SdConfirmNewDir Parameters

Parameter

Description

szTitle

Specifies the title of the dialog. To display the default title (“Confirm New Folder”), pass a null string (“”) in this parameter.

szDir

Specifies the name of the directory to confirm. (Obtain this information by calling SdAskDestPath.)

nReserved

Pass zero in this parameter. No other value is allowed.

Return Values

SdConfirmNewDir Return Values

Return Value

Description

YES (1)

Indicates that the Yes button was clicked. The directory has been confirmed and will be created.

NO (0)

Indicates that the No button was clicked. The specified directory will not be created.

< 0

Indicates that the Yes button was clicked but the function was unable to create the new directory.

Additional Information

To view an example of this or other dialogs for your installation, use the Dialog Sampler. In InstallShield, on the Tools menu, point to InstallScript, then click Standard Dialog Sampler or Skinned Dialog Sampler.
The dialog that is displayed by this function cannot be displayed with a skin; it appears the same regardless of whether you have specified a skin.

See Also