WindowsSubstringWithSpecifiedLength-Funktion (winstring.h)

Artikel
08/27/2023

Ruft eine Teilzeichenfolge aus der angegebenen Zeichenfolge ab. Die Teilzeichenfolge beginnt an einer angegebenen Zeichenposition und hat eine angegebene Länge.

Syntax

HRESULT WindowsSubstringWithSpecifiedLength(
  HSTRING string,
  UINT32  startIndex,
  UINT32  length,
  HSTRING *newString
);

Parameter

string

Typ: [in] HSTRING

Die ursprüngliche Zeichenfolge.

startIndex

Typ: [in] UINT32

Die nullbasierte Anfangsposition einer Teilzeichenfolge in dieser Instanz.

length

Typ: [in] UINT32

Die Anzahl der Zeichen in der Teilzeichenfolge.

newString

Typ: [out] HSTRING*

Eine Zeichenfolge, die der Teilzeichenfolge entspricht, die bei startIndex in Zeichenfolge beginnt, oder NULL , wenn startIndex gleich der Länge von Zeichenfolge ist.

Rückgabewert

Typ: HRESULT

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Teilzeichenfolge wurde erfolgreich erstellt.
E_INVALIDARG	newString ist NULL, oder startIndex plus length ist größer als MAXUINT32( 4.294.967.295); d. h. hexadezimale 0xFFFFFFFF.
E_BOUNDS	startIndex ist größer als die Länge der Zeichenfolge, oder startIndex plus length gibt eine Position an, die sich nicht innerhalb der Zeichenfolge befindet.
E_OUTOFMEMORY	Fehler beim Zuweisen der neuen Teilzeichenfolge.

Hinweise

Jeder Aufruf der WindowsSubstringWithSpecifiedLength-Funktion muss mit einem entsprechenden Aufruf von WindowsDeleteString abgeglichen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winstring.h

Weitere Informationen

WindowsDeleteString

Freigeben über