Função lstrcpyW (winbase.h)
Copia uma cadeia de caracteres para um buffer.
Sintaxe
LPWSTR lstrcpyW(
[out] LPWSTR lpString1,
[in] LPCWSTR lpString2
);
Parâmetros
[out] lpString1
Tipo: LPTSTR
Um buffer para receber o conteúdo da cadeia de caracteres apontado pelo parâmetro lpString2. O buffer deve ser grande o suficiente para conter a cadeia de caracteres, incluindo o caractere nulo de encerramento.
[in] lpString2
Tipo: LPTSTR
A cadeia de caracteres terminada em nulo a ser copiada.
Valor de retorno
Tipo: LPTSTR
Se a função for bem-sucedida, o valor retornado será um ponteiro para o buffer.
Se a função falhar, o valor retornado será NULL e lpString1 poderá não ser encerrado em nulo.
Observações
Com uma versão DBCS (conjunto de caracteres de dois bytes) do sistema, essa função pode ser usada para copiar uma cadeia de caracteres DBCS.
A função lstrcpy terá um comportamento indefinido se os buffers de origem e destino se sobrepõem.
Comentários de segurança
Usar essa função incorretamente pode comprometer a segurança do aplicativo. Essa função usa o SEH (tratamento de exceção estruturado) para capturar violações de acesso e outros erros. Quando essa função captura erros SEH, ela retorna NULL sem encerrar nulo a cadeia de caracteres e sem notificar o chamador do erro. O chamador não é seguro para assumir que espaço insuficiente é a condição de erro.lpString1 deve ser grande o suficiente para manter lpString2 e o fechamento '\0', caso contrário, pode ocorrer uma sobrecarga de buffer.
Situações de estouro de buffer são a causa de muitos problemas de segurança em aplicativos e podem causar um ataque de negação de serviço contra o aplicativo se ocorrer uma violação de acesso. Na pior das hipóteses, uma sobrecarga de buffer pode permitir que um invasor insira código executável em seu processo, especialmente se lpString1 for um buffer baseado em pilha.
Considere o uso StringCchCopy; use StringCchCopy(buffer, sizeof(buffer)/sizeof(buffer[0]), src);, esteja ciente de que buffer não deve ser um ponteiro ou usar StringCchCopy(buffer, ARRAYSIZE(buffer), src);, ciente de que, ao copiar para um ponteiro, o chamador é responsável por passar o tamanho da memória apontada para os caracteres.
Nota
O cabeçalho winbase.h define lstrcpy como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |
Consulte também
Conceitual
de referência de
stringCchCopyNEx