Função StrCpyNW (shlwapi.h)

Copia um número especificado de caracteres do início de uma cadeia de caracteres para outra.

Sintaxe

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

Parâmetros

[out] pszDst

Tipo: PTSTR

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe a cadeia de caracteres copiada. Esse buffer deve ter tamanho suficiente para conter os caracteres copiados. Não há garantia de que essa cadeia de caracteres seja terminada em nulo.

[in] pszSrc

Tipo: PCTSTR

Um ponteiro para a cadeia de caracteres de origem terminada em nulo.

cchMax

Tipo: int

O número de caracteres a serem copiados, incluindo o caractere nulo de terminação.

Retornar valor

Tipo: PTSTR

Retorna um ponteiro para pszDst.

Comentários

Aviso de segurança: Usar essa função incorretamente pode comprometer a segurança do aplicativo. Não há garantia de que a cadeia de caracteres copiada seja terminada em nulo. Considere usar uma das alternativas a seguir. StringCbCopy, StringCbCopyEx, StringCbCopyN, StringCbCopyNEx, StringCchCopy, StringCchCopyEx, StringCchCopyN, StringCchCopyNEx. Você deve examinar considerações de segurança: Microsoft Windows Shell antes de continuar.

Requisitos