Método ILockBytes::WriteAt (objidl.h)

El método WriteAt escribe el número especificado de bytes a partir de un desplazamiento especificado desde el principio de la matriz de bytes.

Sintaxis

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

Parámetros

[in] ulOffset

Especifica el punto inicial desde el principio de la matriz de bytes para que se escriban los datos.

[in] pv

Puntero al búfer que contiene los datos que se van a escribir.

[in] cb

Especifica el número de bytes de datos que se van a intentar escribir en la matriz de bytes.

[out] pcbWritten

Puntero a una ubicación donde este método especifica el número real de bytes escritos en la matriz de bytes. Puede establecer este puntero en NULL para indicar que no está interesado en este valor. En este caso, este método no proporciona el número real de bytes escritos.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

ILockBytes::WriteAt escribe los datos especificados en la ubicación especificada de la matriz de bytes. El número de bytes realmente escritos debe devolverse siempre en pcbWritten, incluso si se devuelve un error. Si el recuento de bytes es cero bytes, la operación de escritura no tiene ningún efecto.

Si ulOffset está más allá del final de la matriz de bytes y cb es mayor que cero, ILockBytes::WriteAt aumenta el tamaño de la matriz de bytes. Los bytes de relleno escritos en la matriz de bytes no se inicializan en ningún valor determinado.

Requisitos

Consulte también

ILockBytes: implementación de File-Based

ILockBytes: implementación de memoria global

ILockBytes::ReadAt

ILockBytes::SetSize