Partager via


Méthode IStringTable::AddString (mmc.h)

La méthode IStringTable::AddString permet à un composant logiciel enfichable d’ajouter une chaîne à la table de chaînes du composant logiciel enfichable.

Syntaxe

HRESULT AddString(
  [in]  LPCOLESTR     pszAdd,
  [out] MMC_STRING_ID *pStringID
);

Paramètres

[in] pszAdd

Chaîne à ajouter à la table de chaînes.

[out] pStringID

Pointeur vers l’ID de la chaîne ajoutée à la table de chaînes.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Les chaînes de la table de chaînes sont comptabilisées en référence. Par exemple, l’ajout de la chaîne « Mon texte » à la table de chaînes renvoie un ID, par exemple 1234. L’ajout de « Mon texte » à la table de chaînes une deuxième fois renverra un ID de 1234, et le nombre de références internes pour la chaîne sera incrémenté. Deux appels à IStringTable::D eleteString, ou un seul appel à IStringTable::D eleteAllStrings, seront nécessaires pour supprimer complètement « Mon texte » de la table de chaînes du composant logiciel enfichable.

IStringTable::AddString retourne un ID de chaîne différent de zéro si l’appel à celui-ci a réussi. Les composants logiciels enfichables peuvent donc utiliser 0 en toute sécurité pour indiquer un ID non attribué.

Spécifications

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête mmc.h
DLL Mmcndmgr.dll

Voir aussi

IStringTable

IStringTable::D eleteAllStrings

IStringTable::D eleteString