StrCpyNW-Funktion (shlwapi.h)

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

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