Función OleLoadFromStream (ole2.h)

  • Artículo

Carga un objeto desde la secuencia.

Sintaxis

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

Parámetros

[in] pStm

Puntero a la interfaz IStream en la secuencia desde la que se va a cargar el objeto.

[in] iidInterface

Identificador de interfaz (IID) que el autor de la llamada quiere usar para comunicarse con el objeto después de cargarlo.

[out] ppvObj

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvObj contiene el puntero de interfaz solicitado en el objeto recién cargado.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Código devuelto Descripción
E_OUTOFMEMORY
 Memoria insuficiente para la operación.
E_NOINTERFACE
 El objeto no admite la interfaz especificada.
 

Esta función también puede devolver cualquiera de los valores de error devueltos por las funciones ReadClassStm y CoCreateInstance , y el método IPersistStream::Load .

Comentarios

Importante  

Nota de seguridad: llamar a este método con datos que no son de confianza es un riesgo de seguridad. Llame a este método solo con datos de confianza.

 
Esta función se puede usar para cargar un objeto que admita la interfaz IPersistStream . El CLSID del objeto debe preceder inmediatamente a los datos del objeto en la secuencia, lo que realiza la función complementaria OleSaveToStream (o las operaciones que contiene, que se describen en ese tema).

Si el CLSID de la secuencia es CLSID_NULL, el parámetro ppvObj se establece en NULL.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ole2.h (incluya Ole2.h)
Library Ole32.lib
Archivo DLL Ole32.dll
Conjunto de API ext-ms-win-com-ole32-l1-1-5 (introducido en Windows 10, versión 10.0.15063)

Consulte también

OleSaveToStream