Compartir a través de


Función StrCpyNW (shlwapi.h)

Copia un número especificado de caracteres desde el principio de una cadena a otra.

Nota No use esta función ni la macro StrNCpy . Vea Comentarios para ver funciones alternativas.
 

Sintaxis

PWSTR StrCpyNW(
  [out] PWSTR  pszDst,
  [in]  PCWSTR pszSrc,
        int    cchMax
);

Parámetros

[out] pszDst

Tipo: PTSTR

Puntero a un búfer que, cuando esta función vuelve correctamente, recibe la cadena copiada. Este búfer debe tener un tamaño suficiente para contener los caracteres copiados. No se garantiza que esta cadena termine en null.

[in] pszSrc

Tipo: PCTSTR

Puntero a la cadena de origen terminada en null.

cchMax

Tipo: int

Número de caracteres que se van a copiar, incluido el carácter nulo de terminación.

Valor devuelto

Tipo: PTSTR

Devuelve un puntero a pszDst.

Comentarios

Advertencia de seguridad: El uso incorrecto de esta función puede poner en peligro la seguridad de la aplicación. No se garantiza que la cadena copiada esté terminada en null. Considere la posibilidad de usar una de las siguientes alternativas. StringCbCopy, StringCbCopyEx, StringCbCopyn, StringCbCopynEx, StringCchCopy, StringCchCopyEx, StringCchCopyN, StringCchCopyNEx. Debe revisar consideraciones de seguridad: Microsoft Windows Shell antes de continuar.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 4.71 o posterior)