Función StrNCatA (shlwapi.h)

  • Artículo

Anexa un número especificado de caracteres desde el principio de una cadena al final de otra.

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

Sintaxis

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR psz2,
            int   cchMax
);

Parámetros

[in, out] psz1

Tipo: PTSTR

Puntero a una cadena terminada en null a la que la función anexa los caracteres de psz2. Debe ser lo suficientemente grande como para contener las cadenas combinadas más el carácter nulo de terminación.

psz2

Tipo: PCTSTR

Puntero a la cadena terminada en null que se va a anexar.

cchMax

Tipo: int

Número de caracteres que se van a anexar a psz1 desde el principio de psz2.

Valor devuelto

Tipo: PTSTR

Devuelve un puntero a psz1, que contiene la cadena combinada.

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. Tenga en cuenta que el último argumento, cchMax, es el número de caracteres que se van a copiar en psz1, no necesariamente el tamaño de psz1 en bytes. Considere la posibilidad de usar una de las siguientes alternativas. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatN o StringCchCatNEx. Debe revisar consideraciones de seguridad: Microsoft Windows Shell antes de continuar.

Nota:

El encabezado shlwapi.h define StrNCat 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, 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)