Freigeben über


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