WindowsSubstring-Funktion (winstring.h)

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

Syntax

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

Die Parameter

string

Typ: [in] HSTRING

Die ursprüngliche Zeichenfolge.

startIndex

Typ: [in] UINT32

Die nullbasierte Anfangszeichenposition 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 der Länge der Zeichenfolge entspricht.

Rückgabewert

Typ: HRESULT-

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Description
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 Zuordnen der neuen Teilzeichenfolge.

Bemerkungen

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

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows 8 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Fenster
Header	winstring.h
Library	mincore.lib

Siehe auch

WindowsDeleteString