Función lstrcpyA (winbase.h)

Artículo
08/27/2023

Copia una cadena en un búfer.

Advertencia No use. Considere la posibilidad de usar StringCchCopy en su lugar. Vea la sección Comentarios.

Sintaxis

LPSTR lstrcpyA(
  [out] LPSTR  lpString1,
  [in]  LPCSTR lpString2
);

Parámetros

[out] lpString1

Tipo: LPTSTR

Búfer para recibir el contenido de la cadena a la que apunta el parámetro lpString2 . El búfer debe ser lo suficientemente grande como para contener la cadena, incluido el carácter nulo de terminación.

[in] lpString2

Tipo: LPTSTR

Cadena terminada en null que se va a copiar.

Valor devuelto

Tipo: LPTSTR

Si la función se ejecuta correctamente, el valor devuelto es un puntero al búfer.

Si se produce un error en la función, el valor devuelto es NULL y lpString1 puede no terminar en null.

Comentarios

Con una versión de juego de caracteres de doble byte (DBCS) del sistema, esta función se puede usar para copiar una cadena DBCS.

La función lstrcpy tiene un comportamiento indefinido si los búferes de origen y destino se superponen.

Comentarios de seguridad

El uso incorrecto de esta función puede poner en peligro la seguridad de la aplicación. Esta función usa el control de excepciones estructurado (SEH) para detectar infracciones de acceso y otros errores. Cuando esta función detecta errores SEH, devuelve NULL sin terminar la cadena y sin notificar al autor de la llamada el error. El autor de la llamada no es seguro suponer que el espacio insuficiente es la condición de error.

lpString1 debe ser lo suficientemente grande como para contener lpString2 y el cierre '\0', de lo contrario, puede producirse una saturación del búfer.

Las situaciones de desbordamiento del búfer son la causa de muchos problemas de seguridad en las aplicaciones y 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 lpString1 es un búfer basado en pila.

Considere la posibilidad de usar StringCchCopy en su lugar; StringCchCopy(buffer, sizeof(buffer)/sizeof(buffer[0]), src);use , teniendo en cuenta que buffer no debe ser un puntero o usar StringCchCopy(buffer, ARRAYSIZE(buffer), src);, teniendo en cuenta que, al copiar en un puntero, el autor de la llamada es responsable de pasar el tamaño de la memoria apuntada en caracteres.

Nota

El encabezado winbase.h define lstrcpy como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll