função DPA_SaveStream (dpa_dsa.h)

[DPA_SaveStream está disponível no Windows Vista. Ele pode estar alterado ou indisponível em versões subsequentes. ]

Salva a DPA (matriz de ponteiro dinâmico) em um fluxo escrevendo um cabeçalho e, em seguida, chamando a função de retorno de chamada especificada para gravar cada elemento.

Sintaxe

HRESULT DPA_SaveStream(
  [in] HDPA         hdpa,
  [in] PFNDPASTREAM pfn,
  [in] IStream      *pstream,
  [in] void         *pvInstData
);

Parâmetros

[in] hdpa

Tipo: HDPA

Recebe um identificador para um DPA.

[in] pfn

Tipo: PFNDPASTREAM

A função do retorno de chamada. Consulte PFNDPASTREAM para obter o protótipo da função de retorno de chamada.

[in] pstream

Tipo: IStream*

Um objeto IStream .

[in] pvInstData

Tipo: void*

Um ponteiro para dados de retorno de chamada. pvInstData é passado como um parâmetro para pfn.

Retornar valor

Tipo: HRESULT

Retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	Indica que a função de retorno de chamada não teve êxito ao salvar o elemento; no entanto, o processo deve continuar.
S_FALSE	Indica que, embora o retorno de chamada não tenha sido bem-sucedido, o processo foi ininterrupto.
E_INVALIDARG	Indica que um ou mais dos parâmetros são inválidos.

Comentários

Essa função deve ser chamada diretamente de ComCtl32.dll. É ordinal 10.

O retorno de chamada é responsável por gravar os dados pvInstData no fluxo.

Requisitos

Requisito	Valor
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