GetWCHARArrayFromISStringArray

InstallShield 2016 ยป InstallScript Language Reference

The GetWCHARArrayFromISStringArray function returns a pointer to an array of pointers to Unicode character strings that are contained in the specified array.

Syntax

GetWCHARArrayFromISStringArray ( vArray );

Parameters

GetWCHARArrayFromISStringArray Parameters

Parameter

Description

vArray

Specifies the string array to which you want a pointer.

Return Values

GetWCHARArrayFromISStringArray Return Values

Return Value

Description

pointer

A pointer to an array of pointers to Unicode character strings.

< ISERR_SUCCESS

Indicates that the function failed.

Additional Information

The GetWCHARArrayFromISStringArray function allocates additional memory for the array of pointers and the Unicode character strings. This pointer can be passed to functions that take LPWSTR* arguments. After you are done with the newly created array, call DeleteWCHARArray to delete the array from memory.

If you call CopyCHARArrayToISStringArray to write the data from the array of pointers back to the original string array, be careful when modifying strings that are contained in the array. Since the lengths of the strings that are contained in string arrays are managed internally by the installation, if you change the length of a string the entire string will not be copied back to the original array when you call CopyCHARArrayToISStringArray.

See Also