Método ILockBytes::SetSize (objidl.h)
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 |
Consulte también
ILockBytes: implementación de File-Based