StrCatChainW 함수(shlwapi.h)

두 개의 유니코드 문자열을 연결합니다. 동일한 버퍼에 반복된 연결이 필요할 때 사용됩니다.

구문

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

[out] pszDst

형식: PWSTR

이 함수가 성공적으로 반환될 때 null로 종료된 유니코드 문자열을 수신하는 버퍼에 대한 포인터입니다.

cchDst

형식:DWORD

대상 버퍼의 크기(문자)입니다. 이 버퍼는 종료 null 문자뿐만 아니라 두 문자열을 모두 보유하기에 충분한 크기여야 합니다. 버퍼가 너무 작으면 최종 문자열이 잘립니다.

ichAt

형식:DWORD

추가 작업을 시작할 대상 버퍼의 오프셋입니다. 문자열이 비어 있지 않으면 이 값을 -1로 설정하여 현재 채워진 문자 수(종결 null 문자를 포함하지 않음)를 계산합니다.

[in] pszSrc

형식: PCWSTR

null로 종료된 유니코드 소스 문자열에 대한 포인터입니다.

형식:DWORD

pszDst에 마지막 문자가 추가된 후 null 문자의 오프셋을 반환합니다.

보안 경고: 이 함수를 잘못 사용하면 애플리케이션의 보안이 손상됩니다. 최종 문자열이 null로 종료되는 것은 아닙니다. StringCbCatEx, StringCbCatNEx, StringCchCatEx 또는 StringCchCatNEx 중 하나를 사용하는 것이 좋습니다. 계속하기 전에 보안 고려 사항: Microsoft Windows Shell 을 검토해야 합니다.