Help Center
/
Help Center›AfxNova›DVARIANT Class

DVARIANT.ToStringArrayAllocmethod

Extracts an array of PWSTR values from DVARIANT.

COMmethodDVARIANT.INCdocumented

Syntax

FUNCTION ToStringArrayAlloc (BYVAL pprgsz AS PWSTR PTR) AS ULONG

Parameters

NameDescription
pprgszPointer to a PWSTR PTR variable that will recive a pointer to an array of PWSTR values extracted from the source DVARIANT.

Return value

The count of PWSTR elements extracted from the DVARIANT.

Description

Extracts an array of PWSTR values from DVARIANT.

Remarks

This helper function is used when the calling application expects a DVARIANT to hold an array of PWSTR values.

This function extracts an array of PWSTR values into a newly allocated array. The calling application is responsible for using CoTaskMemFree to free the memory used by each of the strings and to release the array pointed to by pprgn when it is no longer needed.

Reference

  • Include file DVARIANT.INC
  • Defined in AfxNova/DVARIANT.inc:2206
  • Documented in COM/DVARIANT Class.md
  • Topic: DVARIANT Class