CHStringArray::Add-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 Add-Methode fügt am Ende eines Arrays ein neues Element hinzu und erhöht das Array um eins.
Syntax
int throw(CHeap_Exception) Add(
LPCWSTR newElement
);
Parameter
newElement
Das Element, das dem Array hinzugefügt werden soll.
Rückgabewert
Wenn die Add-Methode erfolgreich ist, gibt sie den Index des hinzugefügten Elements zurück.
Hinweise
Wenn SetSize mit einem nGrowBy-Wert größer als 1 verwendet wurde, kann zusätzlicher Arbeitsspeicher zugewiesen werden. Die Obergrenze erhöht sich jedoch nur um eins.
Beispiele
Das folgende Codebeispiel zeigt die Verwendung von Add.
CHStringArray array;
CHString s( L"String 2");
array.Add( L"String 1" ); // Element 0
array.Add( s ); // Element 1
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 |