StrArray COM and API helpers

	StrArray::ToSafeArray
	SAFEARRAY* ToSafeArray (VARTYPE destVtType,                int startIndex = 0, int nCount = -1)

This method will construct a new SAFEARRAY with the COM API.  The safe array can contain a subset, or all of the elements in the StrArray. The safe array is always constructed as one-dimensional, with a lower bound of zero, and contains the array strings formatted as either BSTR values, or VARIANTs containing a VT_BSTR value.

• destVtType: the desired type of the elements in the resulting array.  Only two values are permitted: VT_BSTR (return an array of BSTR-s) or VT_VARIANT (return an array of VARIANTs initialized to VT_BSTR)
• startIndex: starting index within the StrArray from which to begin copying elements
• nCount: number of elements to copy (starting at startIndex) into the returned SAFEARRAY.  Passing -1 (the default) means "all elements till the end of the StrArray" 

The returned SAFEARRAY is resizeable and can be further manipulated with COM functions, passed to other objects and so on.  To dispose the SAFEARRAY and all associated memory, call the SafeArrayDestroy Windows API function.

See also:  StrArray class