WindowsSubstringWithSpecifiedLength-Funktion (winstring.h)

  • Artikel

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