WindowsSubstring-Funktion (winstring.h)

  • Artikel

Ruft eine Teilzeichenfolge aus der angegebenen Zeichenfolge ab. Die Teilzeichenfolge beginnt an der angegebenen Zeichenposition.

Syntax

HRESULT WindowsSubstring(
  HSTRING string,
  UINT32  startIndex,
  HSTRING *newString
);

Parameter

string

Typ: [in] HSTRING

Die ursprüngliche Zeichenfolge.

startIndex

Typ: [in] UINT32

Die nullbasierte Anfangsposition einer Teilzeichenfolge in dieser Instanz.

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.
E_BOUNDS
 startIndex ist größer als die Länge der Zeichenfolge.
E_OUTOFMEMORY
 Fehler beim Zuweisen der neuen Teilzeichenfolge.

Hinweise

Jeder Aufruf der WindowsSubstring-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