Función StrCatBuffA (shlwapi.h)

Copia y anexa caracteres de una cadena al final de otra.

Nota No use. Vea Comentarios para funciones alternativas.

 

Sintaxis

PSTR StrCatBuffA(
  [in, out] PSTR  pszDest,
  [in]      PCSTR pszSrc,
            int   cchDestBuffSize
);

Parámetros

[in, out] pszDest

Tipo: PTSTR

Un puntero a una cadena terminada en null. Cuando esta función devuelve correctamente, esta cadena contiene su contenido original con la cadena pszSrc anexada.

[in] pszSrc

Tipo: PCTSTR

Puntero a la cadena que se va a anexar a pszDest.

cchDestBuffSize

Tipo: int

Tamaño del búfer, en caracteres, al que apunta pszDest. Este valor debe ser al menos la longitud de la cadena combinada más el carácter nulo de terminación. Si el búfer es demasiado pequeño para ajustarse a toda la cadena, la cadena se truncará.

Valor devuelto

Tipo: PTSTR

Devuelve un puntero a la cadena de destino.

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 final termine en null. 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 StrCatBuff 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

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 5.0 o posterior)