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

Метод ISCardTypeConv::ConvertByteArrayToByteBuffer

  • Статья

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

Метод ConvertByteArrayToByteBuffer преобразует типичный массив байтов C/C++ в универсальный буфер байтов (объект IStream ).

Созданный буфер байтов представляет собой поток, сопоставленный с блоком памяти. Для доступа к буферу или управления им используйте методы, предоставляемые интерфейсом IStream . Уникальной особенностью этой реализации массива является то, что при вызове метода IStream::Release будет освобождена базовая память.

Синтаксис

HRESULT ConvertByteArrayToByteBuffer(
  [in]  LPBYTE       pbyArray,
  [in]  DWORD        dwArraySize,
  [out] LPBYTEBUFFER *ppbyBuffer
);

Параметры

pbyArray [in]

Указатель на массив байтов для преобразования.

dwArraySize [in]

Размер преобразуемого массива байтов.

ppbyBuffer [out]

Указатель на возвращаемый объект IStream .

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

Метод возвращает одно из следующих возможных значений:

Код возврата Описание
S_OK
 Память успешно выделена.
E_INVALIDARG
 Что-то не так с одним или несколькими параметрами, передаваемыми в функцию.
E_POINTER
 Неправильный параметр типа указателя.
E_OUTOFMEMORY
 Недостаточно свободной памяти для удовлетворения запроса.

 

Комментарии

Выделенная память перемещается. Используйте метод IStream::Release , чтобы освободить память.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP
Прекращение поддержки сервера
 Windows Server 2003
Заголовок
Scarddat.h
Библиотека типов
Scarddat.tlb
DLL
Scardssp.dll
IID
 IID_ISCardTypeConv определяется как 53B6AA63-3F56-11D0-916B-00AA00C18068

См. также раздел

ISCardTypeConv

Возвращаемые значения смарт-карты