IByteBuffer::Clone, méthode

Article
06/13/2023

[La méthode Clone 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. L’interface IStream fournit des fonctionnalités similaires.]

La méthode Clone crée un objet avec son propre pointeur de recherche qui référence les mêmes octets que l’objet IByteBuffer d’origine.

Syntaxe

HRESULT Clone(
  [out] LPBYTEBUFFER *ppByteBuffer
);

Paramètres

ppByteBuffer [out]: En cas de réussite, pointe vers l’emplacement d’un pointeur IByteBuffer vers le nouvel objet de flux. Lorsque vous avez terminé d’utiliser le pointeur IByteBuffer , relâchez-le en appelant la fonction IUnknown::Release . Si une erreur se produit, ce paramètre a la valeur NULL.

Valeur retournée

La valeur de retour est un HRESULT. La valeur S_OK indique que l’appel a réussi.

Notes

Cette méthode crée un objet de flux pour accéder aux mêmes octets, mais à l’aide d’un pointeur de recherche distinct. Le nouvel objet stream voit les mêmes données que l’objet de flux source. Les modifications écrites dans un objet sont immédiatement visibles dans l’autre objet. Le verrouillage de plage est partagé entre les objets de flux.

Le paramètre initial du pointeur de recherche dans le flux cloné instance est identique au paramètre actuel du pointeur de recherche dans le flux d’origine au moment de l’opération de clonage.

Exemples

L’exemple suivant montre le clonage de l’interface IByteBuffer .

HRESULT  hr;

// Clone the buffer.
hr = pIByteBuff->Clone(&pIByteClone);
if (FAILED(hr))
  printf("Failed IByteBuffer::Clone\n");

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	Scardssp.h
Bibliothèque de types	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer est défini comme E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Partager via