CHStringArray::GetAt(int)-Methode (chstrarr.h)

Artikel
02/23/2024

[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 GetAt-Methode ruft das Arrayelement am angegebenen Index ab.

Syntax

CHString GetAt(
  int nIndex
);

Parameter

nIndex

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

Hinweis Der nIndex-Parameter muss größer oder gleich 0 sein. Die Debugversion der CHStringArray-Bibliothek überprüft die Grenzen von nIndex. die Releaseversion nicht.

Rückgabewert

Wenn die GetAt-Methode erfolgreich ist, gibt sie das CHString-Zeigerelement zurück, das sich derzeit an diesem Index befindet.

Hinweise

Das Übergeben eines negativen Werts oder eines Werts, der größer als der von GetUpperBound zurückgegebene Wert ist, führt zu einer fehlerhaften Assertion für Debugbuilds.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung von CHStringArray::GetAt.

CHStringArray array;

array.Add( L"String 1" ); // Element 0 
array.Add( L"String 2" ); // Element 1 
assert( array.GetAt( 0 ) == "String 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