WindowsDuplicateString-Funktion (winstring.h)

  • Artikel

Erstellt eine Kopie der angegebenen Zeichenfolge.

Syntax

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Parameter

string

Typ: [in] HSTRING

Die zu kopierende Zeichenfolge.

newString

Typ: [out] HSTRING*

Eine Kopie der Zeichenfolge.

Rückgabewert

Typ: HRESULT

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der HSTRING wurde erfolgreich kopiert.
E_INVALIDARG
 newString ist NULL.
E_OUTOFMEMORY
 Fehler beim Zuweisen des neuen HSTRING.

Hinweise

Verwenden Sie die WindowsDuplicateString-Funktion , um einen HSTRING zu kopieren. Wenn Zeichenfolge durch Aufrufen der WindowsCreateString-Funktion erstellt wurde, wird die Verweisanzahl des Sicherungspuffers erhöht. Wenn Zeichenfolge durch Aufrufen der WindowsCreateStringReference-Funktion erstellt wurde, kopiert der Windows-Runtime seine Quellzeichenfolge in einen neuen Puffer und startet eine Verweisanzahl, was bedeutet, dass newString keine Schnellpasszeichenfolge ist.

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

Anforderungen

Anforderung Wert
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

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString