Share via

StringCchCopyNA 함수(strsafe.h)

  • 아티클

지정된 수의 문자를 한 문자열에서 다른 문자열로 복사합니다. StringCchCopyN이 이 버퍼의 끝을 지나서 작성되지 않도록 대상 버퍼의 크기가 함수에 제공됩니다.

StringCchCopyN 은 다음 함수를 대체합니다.

구문

STRSAFEAPI StringCchCopyNA(
  [out] STRSAFE_LPSTR  pszDest,
  [in]  size_t         cchDest,
  [in]  STRSAFE_PCNZCH pszSrc,
  [in]  size_t         cchToCopy
);

매개 변수

[out] pszDest

형식: LPTSTR

복사된 문자를 받는 대상 버퍼입니다.

[in] cchDest

형식: size_t

pszDest의 크기(문자). 이 값은 복사된 문자( pszSrc 의 길이 또는 cchSrc 값 중 더 작은 값)와 종료되는 null 문자를 고려하여 1을 포함할 수 있을 만큼 커야 합니다. 허용되는 최대 문자 수는 STRSAFE_MAX_CCH.

[in] pszSrc

형식: LPCTSTR

원본 문자열입니다. 이 문자열은 먼저 제공되는 cchSrc 문자 또는 null 종결자까지 읽을 수 있어야 합니다.

[in] cchToCopy

형식: size_t

pszSrc에서 pszDest로 복사할 최대 문자 수입니다.

반환 값

형식: HRESULT

이 함수는 다음 값 중 하나를 반환할 수 있습니다. SUCCEEDED 및 FAILED 매크로를 사용하여 이 함수의 반환 값을 테스트하는 것이 좋습니다.

반환 코드 Description
S_OK
 원본 데이터가 있고, 문자가 잘림 없이 pszSrc 에서 복사되었으며, 결과 대상 버퍼는 null로 종료됩니다.
STRSAFE_E_INVALID_PARAMETER
 cchDest의 값이 STRSAFE_MAX_CCH보다 크거나 대상 버퍼가 이미 가득 찼습니다.
STRSAFE_E_INSUFFICIENT_BUFFER
 버퍼 공간이 부족하여 복사 작업이 실패했습니다. 대상 버퍼에는 의도한 결과의 잘린 null 종료 버전이 포함됩니다. 잘림이 허용되는 상황에서는 반드시 실패 조건으로 간주되지 않을 수 있습니다.
 

이 함수는 대체되는 함수와 달리 HRESULT 값을 반환합니다.

설명

StringCchCopyN 은 코드에서 적절한 버퍼 처리를 위한 추가 처리를 제공합니다. 버퍼 처리 불량은 버퍼 오버런과 관련된 많은 보안 문제에 연루됩니다. StringCchCopyN 은 작업 중에 원본 문자열의 내용이 변경되더라도 항상 null을 종료하고 유효한 대상 버퍼를 오버플로하지 않습니다.

이 루틴은 strncpy를 대체하기 위한 것이지만 동작에는 차이가 있습니다. cchSrc가 pszSrc의 문자 수보다 큰 경우 stringCchCopyN은 strncpy와 달리 cchSrc 문자가 복사될 때까지 pszDest를 null 문자로 채우지 않습니다.

pszSrc 및 pszDest가 가리키는 문자열이 겹치면 동작이 정의되지 않습니다.

pszSrc 또는 pszDest는 NULL이 아니어야 합니다. null 문자열 포인터 값을 처리해야 하는 경우 StringCchCopyNEx 를 참조하세요.

StringCchCopyN 은 제네릭 형식 또는 보다 구체적인 형식으로 사용할 수 있습니다. 문자열의 데이터 형식은 다음 표와 같이 사용해야 하는 이 함수의 형식을 결정합니다.

문자열 데이터 형식 문자열 리터럴 기능
char "문자열" StringCchCopyNA
TCHAR TEXT("string") StringCchCopyN
Wchar L"string" StringCchCopyNW
 

참고

strsafe.h 헤더는 STRINGCchCopyN을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 WINDOWS XP SP2 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 WINDOWS Server 2003 SP1 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 strsafe.h

추가 정보

참조

StringCbCopyN

StringCchCopy

StringCchCopyNEx