DPA_LoadStream, fonction (dpa_dsa.h)

[DPA_LoadStream est disponible dans Windows Vista. Il peut être modifié ou indisponible dans les versions ultérieures. ]

Charge le tableau de pointeurs dynamiques (DPA) à partir d’un flux en appelant la fonction de rappel spécifiée pour lire chaque élément.

Syntaxe

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

[out] phdpa

Type : HDPA*

Handle pour un DPA.

[in] pfn

Fonction de rappel. Consultez PFNDPASTREAM pour le prototype de fonction de rappel.

[in] pstream

Type : IStream*

Objet IStream .

[in] pvInstData

Type : void*

Pointeur vers les données de rappel. pvInstData est passé en tant que paramètre à pfn.

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Indique que la fonction de rappel a réussi et que l’élément a été chargé.
S_FALSE	Indique que la fonction de rappel n’a pas réussi à charger l’élément ; Toutefois, le processus doit se poursuivre.
E_INVALIDARG	Indique qu’un ou plusieurs paramètres ne sont pas valides.
E_FAIL	Indique que l’objet stream n’a pas pu être lu.
E_OUTOFMEMORY	La longueur de la mémoire tampon n’est pas valide ou la mémoire était insuffisante pour terminer l’opération.

Cette fonction doit être appelée directement à partir de ComCtl32.dll. Il s’agit du ordinal 9.

Le rappel est responsable de l’écriture des données pvInstData dans le flux.


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dpa_dsa.h
DLL	ComCtl32.dll