Méthode CHString ::GetBuffer (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 GetBuffer retourne un pointeur vers la mémoire tampon de caractères interne pour l’objet CHString .

Syntaxe

LPWSTR  throw(CHeap_Exception) GetBuffer(
  int nMinBufLength
);

Paramètres

nMinBufLength

Taille minimale de la mémoire tampon de caractères en caractères. Cette valeur n’inclut pas d’espace pour un terminateur NULL .

Valeur retournée

Pointeur LPWSTR vers la mémoire tampon de caractères (terminée par NULL) de l’objet.

Remarques

La LPWSTR retournée n’est pas const et autorise donc la modification directe du contenu CHString .

Si vous utilisez le pointeur retourné par GetBuffer pour modifier le contenu de la chaîne, vous devez appeler ReleaseBuffer avant d’utiliser d’autres méthodes CHString .

Après un appel à ReleaseBuffer, l’adresse retournée par GetBuffer peut ne pas être valide, car des opérations CHString supplémentaires peuvent entraîner la réaffectation de la mémoire tampon CHString . Si vous ne modifiez pas la longueur de la chaîne CHString , la mémoire tampon n’est pas réaffectée. La mémoire tampon est libérée automatiquement lorsque l’objet CHString est détruit.

Notez que si vous effectuez vous-même le suivi de la longueur de chaîne, vous ne devez pas ajouter le caractère NULL de fin. Toutefois, vous devez spécifier la longueur de chaîne finale lorsque vous relâchez la mémoire tampon avec ReleaseBuffer. Si vous ajoutez un caractère NULL de fin, vous devez passer –1 pour la longueur à ReleaseBuffer, qui appelle wcslen sur la mémoire tampon pour déterminer sa longueur.

Configuration requise

Voir aussi

CHString

CHString ::GetBufferSetLength

CHString ::ReleaseBuffer