IByteBuffer :: deinstalle, méthode
[La méthode configure peut être utilisée dans les systèmes d’exploitation spécifiés dans la section 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. L’interface IStream offre des fonctionnalités similaires.]
La méthode configure modifie la taille de l’objet de flux.
Syntaxe
HRESULT SetSize(
[in] LONG libNewSize
);
Paramètres
-
libNewSize [ dans]
-
Nouvelle taille du flux sous la forme d’un nombre d’octets
Valeur de retour
La valeur de retour est un HRESULT. La valeur S _ OK indique que l’appel a réussi.
Notes
La méthode IByteBuffer :: configure modifie la taille de l’objet de flux. Appelez cette méthode pour préallouer de l’espace pour le flux. Si le paramètre libNewSize est plus grand que la taille de flux actuelle, le flux est étendu à la taille indiquée en remplissant l’espace intermédiaire avec des octets de valeur non définie. Cette opération est semblable à la méthode IByteBuffer :: Write si le pointeur de recherche se trouve au-delà de la fin de flux actuelle.
Si le paramètre libNewSize est plus petit que le flux actuel, le flux est tronqué à la taille indiquée.
Le pointeur de recherche n’est pas affecté par la modification de la taille du flux.
L’appel de IByteBuffer :: assets peut être un moyen efficace d’obtenir un grand bloc d’espace contigu.
Exemples
L’exemple suivant illustre la définition de la taille de la mémoire tampon.
LONG lNewSize = 256;
HRESULT hr;
// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
printf("Failed IByteBuffer::SetSize\n");
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 |
|
| Bibliothèque de types |
|
| DLL |
|
| IID |
IID _ IByteBuffer est défini en tant que E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |