Méthode CHStringArray ::SetSize (chstrarr.h)
[La classe CHStringArray 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 dans tout nouveau développement.]
La méthode SetSize établit la taille d’un tableau vide ou existant.
Syntaxe
void throw(CHeap_Exception) SetSize(
int nNewSize,
int nGrowBy
);
Paramètres
nNewSize
Nouvelle taille de tableau (nombre d’éléments). La valeur doit être supérieure ou égale à 0 (zéro).
nGrowBy
Nombre minimal d’emplacements d’éléments à allouer si une augmentation de taille est nécessaire.
Valeur retournée
Cette méthode ne retourne pas de valeur.
Notes
La méthode SetSize alloue de la mémoire si nécessaire. Si la nouvelle taille est inférieure à l’ancienne, le tableau est tronqué et toute la mémoire inutilisée est libérée. Pour plus d’efficacité, appelez SetSize pour définir la taille du tableau avant de l’utiliser. Cela évite de devoir réallouer et copier le tableau chaque fois qu’un élément est ajouté.
Le paramètre nGrowBy affecte l’allocation de mémoire interne pendant la croissance du tableau. Son utilisation n’affecte jamais la taille du tableau, comme indiqué par GetSize et GetUpperBound.
Exemples
Consultez l’exemple pour CHStringArray ::GetData.
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 | chstrarr.h (include FwCommon.h) |
| Bibliothèque | FrameDyn.lib |
| DLL | FrameDynOS.dll ; FrameDyn.dll |