WindowsDuplicateString-Funktion (winstring.h)
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 |
|---|---|
|
Der HSTRING wurde erfolgreich kopiert. |
|
newString ist NULL. |
|
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 |