Função StrCpyW (shlwapi.h)

Copia uma cadeia de caracteres para outra.

Sintaxe

PWSTR StrCpyW(
  [out] PWSTR  psz1,
  [in]  PCWSTR psz2
);

Parâmetros

[out] psz1

Tipo: PTSTR

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

[in] psz2

Tipo: PCTSTR

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

Valor retornado

Tipo: PTSTR

Retorna um ponteiro para psz1.

Comentários

Aviso de segurança: Usar essa função incorretamente pode comprometer a segurança do aplicativo. O primeiro argumento, psz1, deve ser grande o suficiente para manter psz2 e o fechamento '\0', caso contrário, um estouro de buffer pode ocorrer. Os estouros de buffer podem levar a um ataque de negação de serviço contra o aplicativo se ocorrer uma violação de acesso. Na pior das hipóteses, um estouro de buffer pode permitir que um invasor injete código executável em seu processo, especialmente se psz1 for um buffer baseado em pilha. Considere usar uma das seguintes alternativas: StringCbCopy, StringCbCopyEx, StringCbCopyN, StringCbCopyNEx, StringCchCopy, StringCchCopyEx, StringCchCopyN ou StringCchCopyNEx. Você deve examinar considerações de segurança: Microsoft Windows Shell antes de continuar.

Requisitos