Поделиться через

Метод IByteBuffer::SetSize

  • Статья

[Метод SetSize доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Интерфейс IStream предоставляет аналогичные функциональные возможности.]

Метод SetSize изменяет размер объекта потока.

Синтаксис

HRESULT SetSize(
  [in] LONG libNewSize
);

Параметры

libNewSize [in]

Новый размер потока в виде числа байтов

Возвращаемое значение

Возвращаемое значение — HRESULT. Значение S_OK указывает, что вызов выполнен успешно.

Комментарии

Метод IByteBuffer::SetSize изменяет размер объекта потока. Вызовите этот метод для предварительного выделения пространства для потока. Если параметр libNewSize больше текущего размера потока, поток расширяется до указанного размера путем заполнения промежуточного пространства байтами неопределенного значения. Эта операция аналогична методу IByteBuffer::Write , если указатель поиска находится за текущим концом потока.

Если параметр libNewSize меньше текущего потока, поток усекается до указанного размера.

Изменение размера потока не влияет на указатель поиска.

Вызов IByteBuffer::SetSize может быть эффективным способом получения большого фрагмента непрерывного пространства.

Примеры

В следующем примере показано задание размера буфера.

LONG     lNewSize = 256;
HRESULT  hr;

// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
  printf("Failed IByteBuffer::SetSize\n");

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP
Окончание поддержки сервера
 Windows Server 2003
Заголовок
Scardssp.h
Библиотека типов
Scardssp.tlb
DLL
Scardssp.dll
IID
 IID_IByteBuffer определяется как E126F8FE-A7AF-11D0-B88A-00C04FD424B9