Função StrCpyW (shlwapi.h)

Copia uma cadeia de caracteres para outra.

Nota Não use. Consulte Comentários para funções alternativas.

 

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

Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 4.71 ou posterior)