ISCardTypeConv::ConvertSafeArrayToByteBuffer, méthode
[La méthode ConvertSafeArrayToByteBuffer 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 ConvertSafeArrayToByteBuffer convertit un tableau d’octets défini en tant que SAFEARRAY en 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 ConvertSafeArrayToByteBuffer(
[in] LPSAFEARRAY pbyArray,
[out] LPBYTEBUFFER *ppbyBuff
);
Paramètres
-
pbyArray [in]
-
Pointeur vers le SAFEARRAY à convertir.
-
ppbyBuff [out]
-
Pointeur vers l’objet IStream à retourner.
Valeur retournée
La méthode retourne l’une des valeurs possibles suivantes :
| Code de retour | Description |
|---|---|
|
Mémoire allouée avec succès. |
|
Il y a un problème avec un ou plusieurs paramètres passés à la fonction. |
|
Un paramètre de type pointeur était incorrect. |
|
Mémoire disponible insuffisante pour répondre à la demande. |
Notes
La mémoire allouée est déplaçable. Utilisez la méthode IStream::Release pour libérer la mémoire.
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