WindowsReplaceString-Funktion (winstring.h)

  • Artikel

Ersetzt alle Vorkommen eines Zeichensatzes 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
);

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 BESCHREIBUNG
S_OK
 Die Zeichenfolgenersetzung war erfolgreich.
E_INVALIDARG
 newString ist NULL, stringReplaced ist leer, oder die Länge von Zeichenfolge1 plus die 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.

Hinweise

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

Anforderungen

   
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