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

Artículo
02/29/2024

El método SetSize cambia el tamaño de la matriz de bytes.

Sintaxis

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

Parámetros

[in] cb

Especifica el nuevo tamaño de la matriz de bytes como un número de bytes.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El tamaño de la matriz de bytes se cambió correctamente.
STG_E_ACCESSDENIED	El autor de la llamada no tiene permiso para acceder a la matriz de bytes.
STG_E_MEDIUMFULL	El tamaño de la matriz de bytes no cambia porque no queda espacio en el dispositivo de almacenamiento.

Comentarios

ILockBytes::SetSize cambia el tamaño de la matriz de bytes. Si el parámetro cb es mayor que la matriz de bytes actual, la matriz de bytes se extiende al tamaño indicado rellenando el espacio intermedio con bytes de valor indefinido, como ILockBytes::WriteAt, si el puntero de búsqueda está más allá del final de la secuencia actual.

Si el parámetro cb es menor que la matriz de bytes actual, la matriz de bytes se trunca al tamaño indicado.

Notas a los autores de llamadas

Los autores de llamadas no pueden confiar en STG_E_MEDIUMFULL que se devuelvan en el momento adecuado debido al almacenamiento en búfer de caché en el sistema operativo o la red. Sin embargo, los autores de llamadas deben ser capaces de tratar con este código de retorno porque algunas implementaciones de ILockBytes pueden admitirlo.

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