ISCardTypeConv :: ConvertByteArrayToByteBuffer, méthode

[La méthode ConvertByteArrayToByteBuffer peut être utilisée dans les systèmes d’exploitation spécifiés dans la section relative à la configuration requise. elle n’est pas disponible pour une utilisation dans Windows server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. Les modules de carte à puce offrent des fonctionnalités similaires.]

La méthode ConvertByteArrayToByteBuffer convertit un tableau d’octets C/C++ classique en une mémoire tampon universelle d’octets (objet IStream ).

La mémoire tampon d’octets créée est un flux mappé sur un bloc de mémoire. Pour accéder à la mémoire tampon ou la gérer, utilisez les méthodes fournies par l’interface IStream . Une fonctionnalité unique de cette implémentation de tableau est que lorsque vous appelez la méthode IStream :: Release , la mémoire sous-jacente est libérée pour vous.

Syntaxe

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

Paramètres

pbyArray [ dans]

Pointeur vers le tableau d’octets à convertir.

dwArraySize [ dans]

Taille du tableau d’octets à convertir.

ppbyBuffer [ à]

Pointeur vers l’objet IStream à retourner.

Valeur de retour

La méthode retourne l’une des valeurs possibles suivantes :

Code de retour Description
_OK
Mémoire allouée avec succès.
E _ INVALIDARG
Il y a un problème avec un ou plusieurs des paramètres transmis à la fonction.
_pointeur E
Un paramètre de type pointeur était incorrect.
_OUTOFMEMORY E
Mémoire libre insuffisante pour satisfaire la demande.

Notes

La mémoire allouée est déplaçable. Utilisez la méthode IStream :: Release pour libérer de la mémoire.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau XP uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
Fin de la prise en charge des clients
Windows XP
Fin de la prise en charge des serveurs
Windows Server 2003
En-tête
Scarddat. h
Bibliothèque de types
Scarddat. tlb
DLL
Scardssp.dll
IID
IID _ ISCardTypeConv est défini en tant que 53B6AA63-3F56-11D0-916B-00AA00C18068

Voir aussi

ISCardTypeConv

Valeurs de retour de carte à puce