Fonction SysAddRefString (oleauto.h)

Note Vous ne devez appeler SysAddRefString que si vous implémentez un moteur de script qui doit vous protéger contre l’exécution de scripts potentiellement malveillants.

 

Augmente d’un seul le nombre de références épinglantes pour la chaîne spécifiée.

Syntaxe

HRESULT SysAddRefString(
  [in] BSTR bstrString
);

Paramètres

[in] bstrString

Chaîne pour laquelle le nombre de références épinglantes doit augmenter. Bien que ce nombre reste supérieur à 0, la mémoire de la chaîne n’est pas libérée par les appels à la fonction SysFreeString .

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les chaînes avec le type de données BSTR n’ont traditionnellement pas eu de nombre de références. Toute l’utilisation existante de ces chaînes continue de fonctionner sans aucune modification. Les fonctions SysAddRefString et SysReleaseString ajoutent la possibilité d’utiliser le comptage de références pour épingler la chaîne dans la mémoire avant d’appeler à partir d’un script non approuvé dans une méthode IDispatch qui peut ne pas s’attendre à ce que le script libère cette mémoire avant le retour de la méthode, de sorte que le script ne peut pas forcer le code de cette méthode à accéder à la mémoire libérée. Une fois qu’une telle méthode est retournée en toute sécurité, les références épinglage doivent être libérées en appelant SysReleaseString.

Configuration requise

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]
Plateforme cible	Windows
En-tête	oleauto.h
Bibliothèque	Mincore.lib
DLL	Oleaut32.dll

Voir aussi

BSTR

SysReleaseString