Função StrCatChainW (shlwapi.h)

Concatena duas cadeias de caracteres Unicode. Usado quando concatenações repetidas para o mesmo buffer são necessárias.

Sintaxe

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

Parâmetros

[out] pszDst

Tipo: PWSTR

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe a cadeia de caracteres Unicode terminada em nulo.

cchDst

Tipo: DWORD

O tamanho do buffer de destino, em caracteres. Esse buffer deve ter tamanho suficiente para manter ambas as cadeias de caracteres, bem como um caractere nulo de terminação. Se o buffer for muito pequeno, a cadeia de caracteres final será truncada.

ichAt

Tipo: DWORD

O deslocamento para o buffer de destino no qual iniciar a ação de acréscimo. Se a cadeia de caracteres não estiver vazia, defina esse valor como -1 para ter o número atual de caracteres preenchidos (sem incluir o caractere nulo de terminação) calculado para você.

[in] pszSrc

Tipo: PCWSTR

Um ponteiro para a cadeia de caracteres de origem Unicode terminada em nulo.

Retornar valor

Tipo: DWORD

Retorna o deslocamento do caractere nulo após o último caractere adicionado a pszDst.

Comentários

Aviso de segurança: Usar essa função incorretamente pode comprometer a segurança do aplicativo. Não há garantia de que a cadeia de caracteres final seja terminada em nulo. Considere usar uma das seguintes alternativas: StringCbCatEx, StringCbCatNEx, StringCchCatEx ou StringCchCatNEx. Você deve examinar considerações de segurança: Microsoft Windows Shell antes de continuar.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 5.5 ou posterior)