Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
DPA_Clone

DPA_Clone function

[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 WINAPI DPA_Clone(
  _In_        const HDPA hdpaSource,
  _Inout_opt_       HDPA hdpaNew
);

Parameters

hdpaSource [in]

Type: const HDPA

A handle to an existing DPA to copy.

hdpaNew [in, out, optional]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

DLL

Comctl32.dll (version 4.0 or later)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft