Función StrCatChainW (shlwapi.h)

Concatena dos cadenas Unicode. Se usa cuando se requieren concatenaciones repetidas en el mismo búfer.

Sintaxis

DWORD StrCatChainW(
  [out] PWSTR  pszDst,
        DWORD  cchDst,
        DWORD  ichAt,
  [in]  PCWSTR pszSrc
);

Parámetros

[out] pszDst

Tipo: PWSTR

Puntero a un búfer que, cuando esta función devuelve correctamente, recibe la cadena Unicode terminada en null.

cchDst

Tipo: DWORD

Tamaño del búfer de destino, en caracteres. Este búfer debe tener un tamaño suficiente para contener ambas cadenas, así como un carácter nulo de terminación. Si el búfer es demasiado pequeño, se trunca la cadena final.

ichAt

Tipo: DWORD

Desplazamiento en el búfer de destino en el que se va a iniciar la acción de anexión. Si la cadena no está vacía, establezca este valor en -1 para que se calcule automáticamente el número actual de caracteres rellenados (no incluido el carácter nulo de terminación).

[in] pszSrc

Tipo: PCWSTR

Puntero a la cadena de origen Unicode terminada en null.

Valor devuelto

Tipo: DWORD

Devuelve el desplazamiento del carácter null después del último carácter agregado a pszDst.

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: StringCbCatEx, StringCbCatNEx, StringCchCatEx o StringCchCatNEx. Debe revisar consideraciones de seguridad: Microsoft Windows Shell antes de continuar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Library	Shlwapi.lib
Archivo DLL	Shlwapi.dll (versión 5.5 o posterior)