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

Метод ISCardTypeConv::ConvertSafeArrayToByteBuffer

  • Статья

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

Метод ConvertSafeArrayToByteBuffer преобразует массив байтов, определенный как SAFEARRAY, в универсальный буфер байтов (объект IStream ).

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

Синтаксис

HRESULT ConvertSafeArrayToByteBuffer(
  [in]  LPSAFEARRAY  pbyArray,
  [out] LPBYTEBUFFER *ppbyBuff
);

Параметры

pbyArray [in]

Указатель на преобразуемый объект SAFEARRAY.

ppbyBuff [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

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