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.

En verrouillant la chaîne dans la mémoire tampon, vous vous assurez que la conservation exclusive de la chaîne sur la mémoire tampon reste intacte.

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

Voir aussi

CHString

CHString ::UnlockBuffer