Método IOpcFactory::CreateStreamOnFile (msopc.h)

Artículo
03/05/2024

Crea una secuencia a través de un archivo. Este método es un contenedor simplificado para una llamada a la función CreateFile . Los parámetros CreateFile que no se exponen a través de este método usan sus valores predeterminados. Para obtener más información, consulte CreateFile.

Sintaxis

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

Parámetros

[in] filename

Nombre del archivo en el que se crea la secuencia.

[in] ioMode

Valor que describe el estado de lectura y escritura de la secuencia que se va a crear.

[in] securityAttributes

Para obtener información sobre la estructura de SECURITY_ATTRIBUTES en este parámetro, vea la función CreateFile .

[in] dwFlagsAndAttributes

La configuración y los atributos del archivo. Para la mayoría de los archivos, se puede usar FILE_ATTRIBUTE_NORMAL .

Para obtener más información sobre este parámetro, vea CreateFile.

[out, retval] stream

Puntero a la interfaz IStream de la secuencia.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	El valor pasado en el parámetro ioMode no es un valor de enumeración OPC_STREAM_IO_MODE válido.
E_POINTER	Al menos uno de los parámetros filename y stream es NULL.
Error de función CreateFile	Código de error HRESULT de la función CreateFile .

Comentarios

No use una secuencia para serializar los datos del paquete cuando se use la misma secuencia para deserializar un paquete, ya que el intento puede dar lugar a un comportamiento indefinido.

Para obtener información sobre el uso de este método al cargar o guardar un paquete, vea la tarea de programación Cargar un paquete o Guardar un paquete .

Compatibilidad con versiones anteriores de Windows

El comportamiento y el rendimiento de este método son los mismos en todas las versiones de Windows compatibles. Para obtener más información, consulte Introducción con packaging API y Platform Update para Windows Vista.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h