Función StrNCatA (shlwapi.h)

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

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.

Requisitos