Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Die HSTRING wurde erfolgreich kopiert. |
|
newString ist NULL. |
|
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 |