Freigeben über

WindowsReplaceString-Funktion (winstring.h)

Ersetzt alle Vorkommen einer Reihe von Zeichen in der angegebenen Zeichenfolge durch einen anderen Satz von Zeichen, um eine neue Zeichenfolge zu erstellen.

Syntax

HRESULT WindowsReplaceString(
  HSTRING string,
  HSTRING stringReplaced,
  HSTRING stringReplaceWith,
  HSTRING *newString
);

Die Parameter

string

Typ: [in] HSTRING

Die ursprüngliche Zeichenfolge.

stringReplaced

Typ: [in] HSTRING

Die zu ersetzende Zeichenfolge.

stringReplaceWith

Typ: [in] HSTRING

Die Zeichenfolge, die alle Vorkommen von stringReplaced ersetzt. Wenn dieser Parameter NULL ist, werden alle Instanzen von stringReplaced entfernt.

newString

Typ: [out] HSTRING*

Eine Zeichenfolge, die dem Original entspricht, mit der Ausnahme, dass alle Instanzen von stringReplaced durch stringReplaceWith ersetzt werden.

Rückgabewert

Typ: HRESULT-

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Description
S_OK
 Die Zeichenfolgenersetzung war erfolgreich.
E_INVALIDARG
 newString ist NULL, stringReplaced ist leer oder die Länge von Zeichenfolge1 plus der Länge von Zeichenfolge2 ist größer als MAXUINT32, was 4.294.967.295 ist; d. h. hexadezimale 0xFFFFFFFF.
E_OUTOFMEMORY
 Fehler beim Zuordnen der neuen Zeichenfolge.

Bemerkungen

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

  • Last updated on