OleLoadFromStream, fonction (ole2.h)

Article
03/04/2024

Charge un objet à partir du flux.

Syntaxe

HRESULT OleLoadFromStream(
  [in]  LPSTREAM pStm,
  [in]  REFIID   iidInterface,
  [out] LPVOID   *ppvObj
);

Paramètres

[in] pStm

Pointeur vers l’interface IStream sur le flux à partir duquel l’objet doit être chargé.

[in] iidInterface

Identificateur d’interface (IID) que l’appelant souhaite utiliser pour communiquer avec l’objet après son chargement.

[out] ppvObj

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppvObj contient le pointeur d’interface demandé sur l’objet nouvellement chargé.

Valeur retournée

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

Code de retour	Description
E_OUTOFMEMORY	Mémoire insuffisante pour l’opération.
E_NOINTERFACE	L’objet ne prend pas en charge l’interface spécifiée.

Cette fonction peut également retourner n’importe quelle valeur d’erreur retournée par les fonctions ReadClassStm et CoCreateInstance , ainsi que par la méthode IPersistStream ::Load .

Remarques

Important

Remarque de sécurité : l’appel de cette méthode avec des données non approuvées est un risque de sécurité. Appelez cette méthode avec des données approuvées uniquement.

Cette fonction peut être utilisée pour charger un objet qui prend en charge l’interface IPersistStream . Le CLSID de l’objet doit immédiatement précéder les données de l’objet dans le flux, ce qui est accompli par la fonction complémentaire OleSaveToStream (ou les opérations qu’elle wrappe, qui sont décrites sous cette rubrique).

Si le CLSID du flux est CLSID_NULL, le paramètre ppvObj est défini sur NULL.

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-5 (introduit dans Windows 10, version 10.0.15063)

Voir aussi

OleSaveToStream

Partager via