GetCArrayFromISArray

InstallShield 2014 ยป InstallScript Language Reference

The GetCArrayFromISArray function returns a pointer to an array of pointers that point to the actual data of the specified array. This function does not allocate any additional memory, but it returns a pointer to the data in the existing array. If vArray is a string array, the returned pointer can be passed to functions that take LPCWSTR* or LPWSTR* arguments; if vArray is a numeric array, the returned pointer can be passed to functions that take LPCDWORD* or LPDWORD* arguments.

Syntax

GetCArrayFromISArray (vArray);

Parameters

GetCArrayFromISArray Parameters

Parameter

Description

vArray

Specifies the array to which you want a pointer.

Return Values

GetCArrayFromISArray Return Values

Return Value

Description

pointer

A pointer to an array of pointers that point to the actual data of the specified array.

< ISERR_SUCCESS

Indicates that the function failed.

Additional Information

Be careful when using the returned pointer to modify strings that are contained in the array. The length of the strings that are contained in string arrays are managed internally by the installation. Therefore, if you change the length of a string, the installation is no longer able to manage the data that are contained in the string array.