ISCardTypeConv :: CreateByteBuffer, méthode

[La méthode CreateByteBuffer 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 CreateByteBuffer crée une mémoire tampon universelle d’octets mappés dans un objet IStream (IByteBuffer).

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 CreateByteBuffer(
  [in]  DWORD        dwAllocSize,
  [out] LPBYTEBUFFER *ppbyBuff
);

Paramètres

dwAllocSize [ dans]

Taille en octets de la mémoire à allouer pour le tableau.

ppbyBuff [ à]

Pointeur vers l’objet IStream à retourner.

Valeur de retour

Les valeurs de retour possibles sont les 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.
_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.

Pour créer un tableau d’octets C/C++ classique, appelez CreateByteArray.

Pour créer un SAFEARRAY Automation de caractères non signés (octets), appelez CreateSafeArray.

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

CreateByteArray

CreateSafeArray