CHString ::LockBuffer, méthode (chstring.h)
[La classe CHString fait partie de l’infrastructure du fournisseur WMI, qui est maintenant considérée dans l’état final, et aucun développement, amélioration ou mise à jour supplémentaire ne sera disponible pour les problèmes non liés à la sécurité affectant ces bibliothèques. Les API MI doivent être utilisées pour tout nouveau développement.]
La méthode LockBuffer verrouille une chaîne dans la mémoire tampon.
Syntaxe
LPWSTR LockBuffer();
Valeur de retour
Renvoie un pointeur vers un objet CHString ou une chaîne terminée par NULL.
Remarques
En appelant LockBuffer, vous créez une copie de la chaîne, puis définissez le nombre de références sur -1.
Lorsque le nombre de références est défini sur -1, la chaîne dans la mémoire tampon est considérée comme étant dans un état verrouillé, ce qui protège la chaîne de deux manières suivantes :
- Aucune autre chaîne ne peut obtenir une référence aux données dans la chaîne verrouillée, même si cette chaîne est affectée à la chaîne verrouillée.
- La chaîne verrouillée ne fait jamais référence à une autre chaîne, même si cette autre chaîne est copiée dans la chaîne verrouillée.
Une fois que vous avez terminé avec LockBuffer, appelez UnlockBuffer pour réinitialiser le nombre de références à 1 (un).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | chstring.h (inclure FwCommon.h) |
| Bibliothèque | FrameDyn.lib |
| DLL | FrameDynOS.dll ; FrameDyn.dll |