Condividi tramite

Funzione StrCatChainW (shlwapi.h)

  • Articolo

Concatena due stringhe Unicode. Usato quando sono necessarie concatenazioni ripetute nello stesso buffer.

Sintassi

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

Parametri

[out] pszDst

Tipo: PWSTR

Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve la stringa Unicode con terminazione Null.

cchDst

Tipo: DWORD

Dimensioni del buffer di destinazione, in caratteri. Questo buffer deve avere dimensioni sufficienti per contenere entrambe le stringhe e un carattere null di terminazione. Se il buffer è troppo piccolo, la stringa finale viene troncata.

ichAt

Tipo: DWORD

Offset nel buffer di destinazione in corrispondenza del quale iniziare l'azione di accodamento. Se la stringa non è vuota, impostare questo valore su -1 in modo che venga calcolato automaticamente il numero corrente di caratteri compilati (senza includere il carattere Null di terminazione).

[in] pszSrc

Tipo: PCWSTR

Puntatore alla stringa di origine Unicode con terminazione Null.

Valore restituito

Tipo: DWORD

Restituisce l'offset del carattere Null dopo l'ultimo carattere aggiunto a pszDst.

Commenti

Avviso di sicurezza: L'uso di questa funzione in modo non corretto può compromettere la sicurezza dell'applicazione. Non è garantito che la stringa finale sia con terminazione Null. È consigliabile usare una delle alternative seguenti: StringCbCatEx, StringCbCatNEx, StringCchCatEx o StringCchCatNEx. Prima di continuare, vedere Considerazioni sulla sicurezza: Microsoft Windows Shell .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlwapi.h
Libreria Shlwapi.lib
DLL Shlwapi.dll (versione 5.5 o successiva)