função DPA_LoadStream (dpa_dsa.h)

  • Artigo

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

Carrega a DPA (matriz de ponteiro dinâmico) de um fluxo chamando a função de retorno de chamada especificada para ler cada elemento.

Sintaxe

HRESULT DPA_LoadStream(
  [out] HDPA         *phdpa,
  [in]  PFNDPASTREAM pfn,
  [in]  IStream      *pstream,
  [in]  void         *pvInstData
);

Parâmetros

[out] phdpa

Tipo: HDPA*

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.

Valor retornado

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 foi bem-sucedida e o elemento foi carregado.
S_FALSE
 Indica que a função de retorno de chamada não teve êxito ao carregar o elemento; no entanto, o processo deve continuar.
E_INVALIDARG
 Indica que um ou mais dos parâmetros são inválidos.
E_FAIL
 Indica que o objeto de fluxo não pôde ser lido.
E_OUTOFMEMORY
 O comprimento do buffer é inválido ou não havia memória suficiente para concluir a operação.

Comentários

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

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

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