Метод 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

ILockBytes — реализация глобальной памяти

ILockBytes::ReadAt

ILockBytes::WriteAt