SHStrDupW-Funktion (shlwapi.h)
Erstellt eine Kopie einer Zeichenfolge im neu zugewiesenen Arbeitsspeicher.
Syntax
LWSTDAPI SHStrDupW(
[in] LPCWSTR psz,
[out] LPWSTR *ppwsz
);
Parameter
[in] psz
Typ: LPCTSTR
Ein Zeiger auf die zu kopierende NULL-Zeichenfolge.
[out] ppwsz
Typ: LPTSTR*
Ein Zeiger auf eine zugeordnete Unicode-Zeichenfolge, die das Ergebnis enthält. SHStrDup weist arbeitsspeicher für diese Zeichenfolge mit CoTaskMemAlloc zu. Sie sollten die Zeichenfolge mit CoTaskMemFree freigeben, wenn sie nicht mehr benötigt wird.
Im Falle eines Fehlers ist dieser Wert NULL.
Rückgabewert
Typ: HRESULT
Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Fehlerwert zurück.
Hinweise
Diese Funktion verwendet entweder Unicode- oder ANSI-Zeichenfolgen als Eingabe, aber die kopierte Zeichenfolge ist immer Unicode.
Diese Funktion verwendet CoTaskMemAlloc , um Arbeitsspeicher für die kopierte Zeichenfolge zuzuweisen. Sie müssen diesen Arbeitsspeicher mit CoTaskMemFree freigeben, wenn er nicht mehr benötigt wird.
Hinweis
Der shlwapi.h-Header definiert SHStrDup als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
Bibliothek | Shlwapi.lib |
DLL | Shlwapi.dll (Version 5.0 oder höher) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für