ISCardTypeConv::ConvertSafeArrayToByteBuffer (método)

[El método ConvertSafeArrayToByteBuffer está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. No está disponible para su uso en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores, Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. Los módulos de tarjeta inteligente proporcionan una funcionalidad similar.]

El método ConvertSafeArrayToByteBuffer convierte una matriz de bytes definida como SAFEARRAY en un búfer universal de bytes (objeto IStream ).

El búfer de bytes creado es una secuencia asignada a través de un bloque de memoria. Para acceder o administrar el búfer, use los métodos proporcionados por la interfaz IStream . Una característica única sobre esta implementación de matriz es que cuando se llama al método IStream::Release , la memoria subyacente se liberará por usted.

Sintaxis

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

Parámetros

pbyArray [in]

Puntero a SAFEARRAY que se va a convertir.

ppbyBuff [out]

Puntero al objeto IStream que se va a devolver.

Valor devuelto

El método devuelve uno de los siguientes valores posibles:

Código devuelto	Descripción
S_OK	Memoria asignada correctamente.
E_INVALIDARG	Hay algún problema con uno o varios de los parámetros pasados a la función.
E_POINTER	Un parámetro del tipo de puntero era incorrecto.
E_OUTOFMEMORY	No hay suficiente memoria libre para satisfacer la solicitud.

 

Comentarios

La memoria asignada se puede mover. Use el método IStream::Release para liberar la memoria.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Fin de compatibilidad de cliente	Windows XP
Fin de compatibilidad de servidor	Windows Server 2003
Encabezado	Scarddat.h
Biblioteca de tipos	Scarddat.tlb
Archivo DLL	Scardssp.dll
IID	IID_ISCardTypeConv se define como 53B6AA63-3F56-11D0-916B-00AA00C18068

Consulte también

ISCardTypeConv

Valores devueltos de tarjeta inteligente