Share via


Función StrCpyW (shlwapi.h)

Copia una cadena en otra.

Nota No use. Vea Comentarios para funciones alternativas.
 

Sintaxis

PWSTR StrCpyW(
  [out] PWSTR  psz1,
  [in]  PCWSTR psz2
);

Parámetros

[out] psz1

Tipo: PTSTR

Puntero a un búfer que, cuando esta función devuelve correctamente, recibe la cadena copiada. No se garantiza que esta cadena esté terminada en null.

[in] psz2

Tipo: PCTSTR

Puntero a la cadena de origen terminada en null.

Valor devuelto

Tipo: PTSTR

Devuelve un puntero a psz1.

Comentarios

Advertencia de seguridad: El uso incorrecto de esta función puede poner en peligro la seguridad de la aplicación. El primer argumento, psz1, debe ser lo suficientemente grande como para contener psz2 y el cierre '\0', de lo contrario, puede producirse una saturación del búfer. Las saturaciones de búfer pueden provocar un ataque de denegación de servicio contra la aplicación si se produce una infracción de acceso. En el peor de los casos, una saturación de búfer puede permitir que un atacante inserte código ejecutable en el proceso, especialmente si psz1 es un búfer basado en pila. Considere la posibilidad de usar una de las siguientes alternativas: StringCbCopy, StringCbCopyEx, StringCbCopyN, StringCbCopyNEx, StringCchCopyEx, StringCchCopyN o StringCchCopyNEx. Debe revisar consideraciones de seguridad: Microsoft Windows Shell antes de continuar.

Requisitos

   
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)