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
Requisito | Valor |
---|---|
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) |