Метод ISCardTypeConv::CreateByteBuffer
[Метод CreateByteBuffer доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Модули смарт-карт предоставляют аналогичные функциональные возможности.]
Метод CreateByteBuffer создает универсальный буфер байтов, сопоставленный с объектом IStream (IByteBuffer).
Созданный буфер байтов представляет собой поток, сопоставленный с блоком памяти. Для доступа к буферу или управления им используйте методы, предоставляемые интерфейсом IStream . Уникальность этой реализации массива заключается в том, что при вызове метода IStream::Release будет освобождена базовая память.
Синтаксис
HRESULT CreateByteBuffer(
[in] DWORD dwAllocSize,
[out] LPBYTEBUFFER *ppbyBuff
);
Параметры
-
dwAllocSize [in]
-
Размер памяти, выделенной для массива, в байтах.
-
ppbyBuff [out]
-
Указатель на возвращаемый объект IStream.
Возвращаемое значение
Возможные возвращаемые значения:
| Код возврата | Описание |
|---|---|
|
Память успешно выделена. |
|
Что-то не так с одним или несколькими параметрами, переданными в функцию. |
|
Недостаточно свободной памяти для удовлетворения запроса. |
Комментарии
Выделенная память перемещается. Используйте метод IStream::Release , чтобы освободить память.
Чтобы создать типичный массив байтов C/C++, вызовите CreateByteArray.
Чтобы создать safeARRAY службы автоматизации из неподписанных символов (байтов), вызовите CreateSafeArray.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| Окончание поддержки клиентов |
Windows XP |
| Окончание поддержки сервера |
Windows Server 2003 |
| Заголовок |
|
| Библиотека типов |
|
| DLL |
|
| IID |
IID_ISCardTypeConv определяется как 53B6AA63-3F56-11D0-916B-00AA00C18068 |
См. также раздел