función DPA_LoadStream (dpa_dsa.h)

  • Artículo

[DPA_LoadStream está disponible en Windows Vista. Es posible que se modifique o no esté disponible en versiones posteriores. ]

Carga la matriz de punteros dinámicos (DPA) desde una secuencia llamando a la función de devolución de llamada especificada para leer cada elemento.

Sintaxis

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

Parámetros

[out] phdpa

Tipo: HDPA*

Identificador de un DPA.

[in] pfn

Tipo: PFNDPASTREAM

La función de devolución de llamada. Consulte PFNDPASTREAM para ver el prototipo de función de devolución de llamada.

[in] pstream

Tipo: IStream*

Objeto IStream .

[in] pvInstData

Tipo: void*

Puntero a los datos de devolución de llamada. pvInstData se pasa como parámetro a pfn.

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
 Indica que la función de devolución de llamada se realizó correctamente y que el elemento se cargó.
S_FALSE
 Indica que la función de devolución de llamada no se realizó correctamente al cargar el elemento; sin embargo, el proceso debe continuar.
E_INVALIDARG
 Indica que uno o varios de los parámetros no son válidos.
E_FAIL
 Indica que no se pudo leer el objeto de secuencia.
E_OUTOFMEMORY
 La longitud del búfer no es válida o no había memoria suficiente para completar la operación.

Comentarios

Se debe llamar a esta función directamente desde ComCtl32.dll. Es ordinal 9.

La devolución de llamada es responsable de escribir los datos pvInstData en la secuencia.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dpa_dsa.h
Archivo DLL ComCtl32.dll