Método ISequentialStream::Write (objidl.h)

Artículo
08/25/2023

El método Write escribe un número especificado de bytes en el objeto de secuencia a partir del puntero de búsqueda actual.

Sintaxis

HRESULT Write(
  [in]  const void *pv,
  [in]  ULONG      cb,
  [out] ULONG      *pcbWritten
);

Parámetros

[in] pv

Puntero al búfer que contiene los datos que se van a escribir en la secuencia. Se debe proporcionar un puntero válido para este parámetro incluso cuando cb es cero.

[in] cb

Número de bytes de datos que se van a intentar escribir en la secuencia. Este valor puede ser cero.

[out] pcbWritten

Puntero a una variable ULONG donde este método escribe el número real de bytes escritos en el objeto de secuencia. El autor de la llamada puede establecer este puntero en NULL, en cuyo caso este método no proporciona el número real de bytes escritos.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Los datos se escribieron correctamente en el objeto stream.
E_PENDING	Solo almacenamiento asincrónico: la parte o todos los datos que se van a escribir no están disponibles actualmente.
STG_E_MEDIUMFULL	Error en la operación de escritura porque no queda espacio en el dispositivo de almacenamiento.
STG_E_ACCESSDENIED	El autor de la llamada no tiene los permisos necesarios para escribir en este objeto de secuencia.
STG_E_CANTSAVE	Los datos no se pueden escribir por motivos distintos del acceso inadecuado o espacio insuficiente.
STG_E_INVALIDPOINTER	Uno de los valores de puntero no es válido. El parámetro pv debe contener un puntero válido incluso si cb es cero.
STG_E_REVERTED	El objeto ha sido invalidado por una operación de reversión encima de él en el árbol de transacciones.
STG_E_WRITEFAULT	Error en la operación de escritura debido a un error de disco. Este valor también se devuelve cuando este método intenta escribir en una secuencia que se abrió en modo simple (con la marca STGM_SIMPLE).

Comentarios

ISequentialStream::Write escribe los datos especificados en un objeto de secuencia. El puntero de búsqueda se ajusta para el número de bytes escritos realmente. El número de bytes escritos realmente se devuelve en el parámetro pcbWritten . Si el recuento de bytes es cero bytes, la operación de escritura no tiene ningún efecto.

Si el puntero de búsqueda está más allá del final de la secuencia y el recuento de bytes es distinto de cero, este método aumenta el tamaño de la secuencia al puntero de búsqueda y escribe los bytes especificados a partir del puntero de búsqueda. Los bytes de relleno escritos en la secuencia no se inicializan en ningún valor determinado. Esto es lo mismo que el comportamiento del final del archivo en el sistema de archivos FAT de MS-DOS.

Con un recuento de bytes cero y un puntero de búsqueda más allá del final de la secuencia, este método no crea los bytes de relleno para aumentar la secuencia al puntero de búsqueda. En este caso, debe llamar al método IStream::SetSize para aumentar el tamaño de la secuencia y escribir los bytes de relleno.

El parámetro pcbWritten puede tener un valor incluso si se produce un error.

En la implementación proporcionada por COM, los objetos de secuencia no son dispersos. Los bytes de relleno se asignan finalmente en el disco y se asignan a la secuencia.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objidl.h
Library	Uuid.lib
Archivo DLL	Ole32.dll