Edit

DPA_Clone function (dpa_dsa.h)

  • Article

[DPA_Clone is available through Windows XP with Service Pack 2 (SP2). It might be altered or unavailable in subsequent versions.]

Duplicates a dynamic pointer array (DPA).

Syntax

HDPA DPA_Clone(
  [in]                const HDPA hdpa,
  [in, out, optional] HDPA       hdpaNew
);

Parameters

[in] hdpa

Type: const HDPA

A handle to an existing DPA to copy.

[in, out, optional] hdpaNew

Type: HDPA

When NULL, a new array is copied from hdpaSource.

This parameter can also contain an array created with DPA_Create or DPA_CreateEx. The data is overwritten but the original delta size and heap handle retained.

Return value

Type: HDPA

The handle to the new or altered DPA (hdpaNew) if successful; otherwise, NULL.

Remarks

DPA_Clone is not exported by name or declared in a public header file. To use it, you must use GetProcAddress and request ordinal 331 from ComCtl32.dll to obtain a function pointer.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header dpa_dsa.h
DLL Comctl32.dll (version 4.0 or later)
API set ext-ms-win-shell-comctl32-da-l1-1-0 (introduced in Windows 10, version 10.0.14393)