Metodo IPersistStream::Load (objidl.h)

  • Articolo

Inizializza un oggetto dal flusso in cui è stato salvato in precedenza.

Sintassi

HRESULT Load(
  [in] IStream *pStm
);

Parametri

[in] pStm

Puntatore IStream al flusso da cui deve essere caricato l'oggetto.

Valore restituito

Questo metodo può restituire i valori seguenti.

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.
E_OUTOFMEMORY
 L'oggetto non è stato caricato a causa della mancanza di memoria.
E_FAIL
 L'oggetto non è stato caricato a causa di un motivo diverso da una mancanza di memoria.

Commenti

Questo metodo carica un oggetto dal flusso associato. Il puntatore di ricerca è impostato come era nel metodo IPersistStream::Save più recente. Questo metodo può cercare e leggere dal flusso, ma non può scriverlo.

Note ai chiamanti

Anziché chiamare direttamente IPersistStream::Load , in genere si chiama la funzione OleLoadFromStream :
  1. Chiama la funzione ReadClassStm per ottenere l'identificatore della classe dal flusso.
  2. Chiama la funzione CoCreateInstance per creare un'istanza dell'oggetto.
  3. Esegue query sull'istanza di IPersistStream.
  4. Chiama IPersistStream::Load.
La funzione OleLoadFromStream presuppone che gli oggetti vengano archiviati nel flusso con un identificatore di classe seguito dai dati dell'oggetto. Questo modello di archiviazione viene usato dall'implementazione generica e composita del moniker fornita da OLE.

Se gli oggetti non vengono archiviati usando questo modello, è necessario chiamare i metodi separatamente.

Note sul moniker URL

Inizializza un moniker URL dai dati all'interno di un flusso, in genere archiviato in precedenza usando IPersistStream::Save (usando OleSaveToStream). Il formato binario del moniker URL è la stringa URL in Unicode (può essere una stringa URL completa o parziale, vedere CreateURLMonikerEx per informazioni dettagliate). Questo valore è rappresentato come numero ULONG di caratteri seguiti da molti caratteri Unicode.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione objidl.h

Vedi anche

Ipersiststream