Função DPA_Clone (dpa_dsa.h)

[DPA_Clone está disponível por meio do Windows XP com Service Pack 2 (SP2). Ele pode estar alterado ou indisponível em versões subsequentes.]

Duplica uma DPA (matriz de ponteiro dinâmico).

Sintaxe

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

Parâmetros

[in] hdpa

Tipo: const HDPA

Um identificador para um DPA existente a ser copiado.

[in, out, optional] hdpaNew

Tipo: HDPA

Quando NULL, uma nova matriz é copiada do hdpaSource.

Esse parâmetro também pode conter uma matriz criada com DPA_Create ou DPA_CreateEx. Os dados são substituídos, mas o tamanho delta original e o identificador de heap são mantidos.

Valor retornado

Tipo: HDPA

O identificador para o DPA novo ou alterado (hdpaNew) se tiver êxito; caso contrário, NULL.

Comentários

DPA_Clone não é exportado por nome ou declarado em um arquivo de cabeçalho público. Para usá-lo, você deve usar GetProcAddress e solicitar o ordinal 331 de ComCtl32.dll para obter um ponteiro de função.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dpa_dsa.h
DLL	Comctl32.dll (versão 4.0 ou posterior)
Conjunto de APIs	ext-ms-win-shell-comctl32-da-l1-1-0 (introduzido no Windows 10, versão 10.0.14393)