SHLocalStrDupW-Funktion (shlwapi.h)

Artikel
11/20/2024

Erstellt eine Kopie einer Zeichenfolge im neu zugewiesenen Speicher.

Syntax

HRESULT SHLocalStrDupW(
                  PCWSTR psz,
  [out, optional] PWSTR  *ppsz
);

Parameter

psz

Typ: PCTSTR-

Ein Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die kopiert werden soll.

[out, optional] ppsz

Typ: PTSTR*

Die Adresse eines Zeigers auf eine zugeordnete Zeichenfolge, die, wenn diese Funktion erfolgreich zurückgegeben wird, das Ergebnis empfängt. SHLocalStrDup weist speicher für diese Zeichenfolge mit LocalAlloc-zu. Sie sollten die Zeichenfolge mit LocalFree freigeben, wenn sie nicht mehr benötigt wird.

Rückgabewert

Typ: HRESULT-

Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Anmerkung

Der Header "shlwapi.h" definiert SHLocalStrDup 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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h

Freigeben über