ISCardTypeConv::CreateByteBuffer, méthode
[La méthode CreateByteBuffer peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il 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 à 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 ou gérer la mémoire tampon, 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 [in]
-
Taille en octets de la mémoire à allouer pour le tableau.
-
ppbyBuff [out]
-
Pointeur vers l’objet IStream à retourner.
Valeur retournée
Les valeurs de retour possibles sont les suivantes :
| Code de retour | Description |
|---|---|
|
Mémoire allouée avec succès. |
|
Il existe un problème avec un ou plusieurs des paramètres passés à la fonction. |
|
Mémoire libre insuffisante pour répondre à la demande. |
Notes
La mémoire allouée est mobile. Utilisez la méthode IStream::Release pour libérer 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 XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 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 |
|
| Bibliothèque de types |
|
| DLL |
|
| IID |
IID_ISCardTypeConv est défini comme 53B6AA63-3F56-11D0-916B-00AA00C18068 |
Voir aussi