IPersistStream ::Load, méthode (objidl.h)

  • Article

Initialise un objet à partir du flux dans lequel il a été enregistré précédemment.

Syntaxe

HRESULT Load(
  [in] IStream *pStm
);

Paramètres

[in] pStm

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

Valeur retournée

Cette méthode peut retourner les valeurs suivantes.

Code de retour Description
S_OK
 La commande s'est correctement terminée.
E_OUTOFMEMORY
 L’objet n’a pas été chargé en raison d’un manque de mémoire.
E_FAIL
 L’objet n’a pas été chargé pour une raison autre qu’un manque de mémoire.

Remarques

Cette méthode charge un objet à partir de son flux associé. Le pointeur de recherche est défini tel qu’il était dans la méthode IPersistStream ::Save la plus récente. Cette méthode peut rechercher et lire à partir du flux, mais ne peut pas y écrire.

Remarques aux appelants

Au lieu d’appeler IPersistStream ::Load directement, vous appelez généralement la fonction OleLoadFromStream :
  1. Appelle la fonction ReadClassStm pour obtenir l’identificateur de classe à partir du flux.
  2. Appelle la fonction CoCreateInstance pour créer un instance de l’objet .
  3. Interroge le instance pour IPersistStream.
  4. Appelle IPersistStream ::Load.
La fonction OleLoadFromStream suppose que les objets sont stockés dans le flux avec un identificateur de classe suivi des données de l’objet. Ce modèle de stockage est utilisé par l’implémentation générique de moniker composite fournie par OLE.

Si les objets ne sont pas stockés à l’aide de ce modèle, vous devez appeler les méthodes séparément vous-même.

Remarques sur le moniker d’URL

Initialise un moniker d’URL à partir de données dans un flux, généralement stockés précédemment à l’aide de son IPersistStream ::Save (à l’aide d’OleSaveToStream). Le format binaire du moniker d’URL est sa chaîne d’URL en Unicode (il peut s’agir d’une chaîne d’URL complète ou partielle, voir CreateURLMonikerEx pour plus d’informations). Il s’agit d’un nombre ULONG de caractères suivi de ce nombre de caractères Unicode.

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 objidl.h

Voir aussi

IPersistStream