Freigeben über


WindowsSubstringWithSpecifiedLength-Funktion (winstring.h)

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
);

Die Parameter

string

Typ: [in] HSTRING

Die ursprüngliche Zeichenfolge.

startIndex

Typ: [in] UINT32

Die nullbasierte Anfangszeichenposition 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 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, oder startIndex plus länge ist größer als MAXUINT32, was 4.294.967.295 ist; 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 nicht innerhalb der Zeichenfolge liegt.
E_OUTOFMEMORY
Fehler beim Zuordnen der neuen Teilzeichenfolge.

Bemerkungen

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