CHStringArray::SetAt(int,LPCWSTR)-Methode (chstrarr.h)

Artikel
08/22/2023

[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 SetAt-Methode legt das Arrayelement am angegebenen Index fest.

Syntax

void SetAt(
  int     nIndex,
  LPCWSTR newElement
);

Parameter

nIndex

Ein ganzzahliger Index, der größer oder gleich 0 und kleiner oder gleich dem von GetUpperBound zurückgegebenen Wert ist.

newElement

Der Objektzeiger, der in dieses Array eingefügt wird. Ein NULL-Wert ist zulässig.

Rückgabewert

Keine

Bemerkungen

Die SetAt-Methode bewirkt nicht, dass das Array vergrößert wird. Verwenden Sie SetAtGrow , wenn das Array automatisch erhöht werden soll.

Sie müssen sicherstellen, dass Ihr Indexwert eine gültige Position im Array darstellt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung von CHStringArray::SetAt veranschaulicht.

CHStringArray array;

array.Add( L"String 1" ); // Element 0
array.Add( L"String 2" ); // Element 1
array.SetAt( 0, L"String 3" );  // Replace element 0.
assert( array[0] == "String 3" );

Das folgende Beispiel führt zu einem CHStringArray mit zwei Elementen.

    [0] = String 3
    [1] = String 2

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