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

Artículo
11/20/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 . parámetros createFile que no se exponen a través de este método usan sus valores predeterminados. Para obtener más información, vea 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, consulte 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 de IStream de la secuencia.

Valor devuelto

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

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
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 de nombre de archivo y secuencia es null.
error de función CreateFile	Código de error HRESULT de la función createFile .

Observaciones

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

Para obtener información sobre cómo usar este método al cargar o guardar un paquete, consulte la tarea de programación Carga de un paquete o Guardar un paquete tarea de programación.

compatibilidad con en 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, vea Introducción a la API de empaquetadoy Platform Update para Windows Vista.

Seguridad de subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte la Introducción a la API de empaquetado.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 R2, Windows Server 2008 con SP2 y Platform Update para Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	msopc.h