Partager via


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
);

Paramètres

[out] phdpa

Type : HDPA*

Handle pour un DPA.

[in] pfn

Type : PFNDPASTREAM

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.

Valeur retournée

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.

Notes

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.

Spécifications

   
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