CHStringArray::SetSize-Methode (chstrarr.h)
[Die Klasse CHStringArray ist Teil des WMI-Anbieterframeworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]
Die SetSize-Methode legt die Größe eines leeren oder vorhandenen Arrays fest.
Syntax
void throw(CHeap_Exception) SetSize(
int nNewSize,
int nGrowBy
);
Parameter
nNewSize
Die neue Arraygröße (Anzahl der Elemente). Der Wert muss größer oder gleich 0 (null) sein.
nGrowBy
Die mindeste Anzahl von Elementslots, die zugeordnet werden sollen, wenn eine Größenvergrößerung erforderlich ist.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Bemerkungen
Die SetSize-Methode belegt bei Bedarf Arbeitsspeicher. Wenn die neue Größe kleiner als die alte Größe ist, wird das Array abgeschnitten, und der gesamte nicht verwendete Arbeitsspeicher wird freigegeben. Rufen Sie aus Effizienzgründen SetSize auf, um die Größe des Arrays festzulegen, bevor Sie es verwenden. Dadurch wird verhindert, dass das Array jedes Mal neu zugeordnet und kopiert werden muss, wenn ein Element hinzugefügt wird.
Der Parameter nGrowBy wirkt sich auf die interne Speicherbelegung aus, während das Array wächst. Seine Verwendung wirkt sich nie auf die Arraygröße aus, wie von GetSize und GetUpperBound gemeldet.
Beispiele
Sehen Sie sich das Beispiel für CHStringArray::GetData an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | chstrarr.h (einschließlich FwCommon.h) |
| Bibliothek | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |