WindowsDuplicateString-Funktion (winstring.h)

Erstellt eine Kopie der angegebenen Zeichenfolge.

Syntax

HRESULT WindowsDuplicateString(
  HSTRING string,
  HSTRING *newString
);

Die 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	Description
S_OK	Die HSTRING wurde erfolgreich kopiert.
E_INVALIDARG	newString ist NULL.
E_OUTOFMEMORY	Fehler beim Zuordnen des neuen HSTRING.

Bemerkungen

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

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

WindowsCreateString

WindowsCreateStringReference

WindowsDeleteString