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 |
|---|---|
|
Memoria asignada correctamente. |
|
Hay algún problema con uno o varios de los parámetros pasados a la función. |
|
Un parámetro del tipo de puntero era incorrecto. |
|
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 |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| IID |
IID_ISCardTypeConv se define como 53B6AA63-3F56-11D0-916B-00AA00C18068 |
Consulte también