Compartir a través de


Función StrCatBuffA (shlwapi.h)

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

Nota No usar. Consulte Comentarios para funciones alternativas.
 

Sintaxis

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

Parámetros

[in, out] pszDest

Tipo: PTSTR de

Puntero a una cadena terminada en null. Cuando esta función se devuelve correctamente, esta cadena contiene su contenido original con la cadena pszSrc anexado.

[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, se truncará la cadena.

Valor devuelto

Tipo: PTSTR de

Devuelve un puntero a la cadena de destino.

Observaciones

advertencia de seguridad: Usar esta función incorrectamente 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, StringCchCatNo 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de shlwapi.h
biblioteca de Shlwapi.lib
DLL de Shlwapi.dll (versión 5.0 o posterior)