fonction DPA_SaveStream (dpa_dsa.h)

  • Article

[DPA_SaveStream est disponible dans Windows Vista. Il peut être modifié ou indisponible dans les versions suivantes. ]

Enregistre le tableau de pointeurs dynamiques (DPA) dans un flux en écrivant un en-tête, puis en appelant la fonction de rappel spécifiée pour écrire chaque élément.

Syntaxe

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

Paramètres

[in] hdpa

Type : HDPA

Reçoit un 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 n’a pas réussi à enregistrer l’élément ; toutefois, le processus doit se poursuivre.
S_FALSE
 Indique que même si le rappel a échoué, le processus a été ininterrompu.
E_INVALIDARG
 Indique qu’un ou plusieurs des paramètres n’est pas valide.

Remarques

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

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

Configuration requise

Condition requise Valeur
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