Função StrCpyNW (shlwapi.h)

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

Nota Não use essa função ou a macro StrNCpy . Consulte Comentários para funções alternativas.

 

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)