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

Weitere Informationen

CHStringArray

CHStringArray::GetData

CHStringArray::GetSize

CHStringArray::GetUpperBound