StrCpyNW-Funktion (shlwapi.h)

  • Artikel

Kopiert eine angegebene Anzahl von Zeichen vom Anfang einer Zeichenfolge in eine andere.

Hinweis Verwenden Sie diese Funktion oder das StrNCpy-Makro nicht. Weitere Informationen finden Sie unter Hinweise zu alternativen Funktionen.
 

Syntax

PWSTR StrCpyNW(
  [out] PWSTR  pszDst,
  [in]  PCWSTR pszSrc,
        int    cchMax
);

Parameter

[out] pszDst

Typ: PTSTR

Ein Zeiger auf einen Puffer, der die kopierte Zeichenfolge empfängt, wenn diese Funktion erfolgreich zurückgibt. Dieser Puffer muss eine ausreichende Größe aufweisen, um die kopierten Zeichen enthalten zu können. Es ist nicht garantiert, dass diese Zeichenfolge null-beendet ist.

[in] pszSrc

Typ: PCTSTR

Ein Zeiger auf die NULL-endende Quellzeichenfolge.

cchMax

Typ: int

Die Anzahl der zu kopierenden Zeichen, einschließlich des abschließenden NULL-Zeichens.

Rückgabewert

Typ: PTSTR

Gibt einen Zeiger auf pszDst zurück.

Hinweise

Sicherheitswarnung: Die falsche Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung beeinträchtigen. Es ist nicht garantiert, dass die kopierte Zeichenfolge null-beendet ist. Erwägen Sie die Verwendung einer der folgenden Alternativen. StringCbCopy, StringCbCopyEx, StringCbCopyN, StringCbCopyNEx, StringCchCopy, StringCchCopyEx, StringCchCopyN, StringCchCopyNEx. Lesen Sie sicherheitsrelevante Überlegungen: Microsoft Windows Shell , bevor Sie fortfahren.

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 4.71 oder höher)