OleSaveToStream, fonction (ole2.h)

Article
02/29/2024

Enregistre un objet avec l’interface IPersistStream dans le flux spécifié.

Syntaxe

HRESULT OleSaveToStream(
  [in] LPPERSISTSTREAM pPStm,
  [in] LPSTREAM        pStm
);

Paramètres

[in] pPStm

Pointeur vers l’interface IPersistStream sur l’objet à enregistrer dans le flux. Le paramètre pPStm ne peut pas être NULL.

[in] pStm

Pointeur vers l’interface IStream sur le flux dans lequel l’objet doit être enregistré.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour	Description
STGMEDIUM_E_FULL	L’objet n’a pas pu être enregistré en raison d’un manque d’espace disque.
OLE_E_BLANK	Le paramètre pPStm est NULL.

Cette fonction peut également retourner l’une des valeurs d’erreur retournées par la fonction WriteClassStm ou la méthode IPersistStream ::Save .

Remarques

Cette fonction simplifie l’enregistrement d’un objet qui implémente l’interface IPersistStream dans un flux. Dans ce flux, le CLSID de l’objet précède ses données. Lorsque le flux est récupéré, le CLSID permet d’associer le code approprié aux données. La fonction OleSaveToStream effectue les opérations suivantes :

Appelle la méthode IPersist ::GetClassID pour obtenir le CLSID de l’objet.
Écrit le CLSID dans le flux avec la fonction WriteClassStm .
Appelle la méthode IPersistStream ::Save avec fClearDirty défini sur TRUE, ce qui efface le sale bit dans l’objet.

L’assistant d’assistance, OleLoadFromStream, charge les objets enregistrés de cette manière.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ole2.h (inclure Ole2.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll
Ensemble d’API	ext-ms-win-com-ole32-l1-1-1 (introduit dans Windows 8.1)

Voir aussi

IPersistStream

IStream

OleLoadFromStream

Partager via