Метод ILockBytes::SetSize (objidl.h)
Метод SetSize изменяет размер массива байтов.
Синтаксис
HRESULT SetSize(
[in] ULARGE_INTEGER cb
);
Параметры
[in] cb
Задает новый размер массива байтов в виде числа байтов.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
| S_OK | Размер массива байтов был успешно изменен. |
| STG_E_ACCESSDENIED | Вызывающий объект не имеет разрешения на доступ к массиву байтов. |
| STG_E_MEDIUMFULL | Размер массива байтов не изменяется, так как на устройстве хранения не осталось места. |
Комментарии
ILockBytes::SetSize изменяет размер массива байтов. Если параметр cb больше текущего массива байтов, массив байтов расширяется до указанного размера путем заполнения промежуточного пространства байтами неопределенного значения, как и ILockBytes::WriteAt, если указатель поиска находится за текущим концом потока.
Если параметр cb меньше текущего массива байтов, массив байтов усекается до указанного размера.
Примечания к вызывающим абонентам
Вызывающие стороны не могут полагаться на STG_E_MEDIUMFULL, возвращаемые в соответствующее время из-за буферизации кэша в операционной системе или сети. Однако вызывающие стороны должны иметь возможность работать с этим кодом возврата, так как некоторые реализации ILockBytes могут поддерживать его.Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | objidl.h |
| Библиотека | Uuid.lib |
| DLL | Ole32.dll |
См. также раздел
ILockBytes — реализация File-Based