Share via

StringCbLengthA 함수(strsafe.h)

  • 아티클

문자열이 지정된 길이(바이트)를 초과하는지 여부를 결정합니다.

StringCbLength 는 다음 함수를 대체합니다.

구문

STRSAFEAPI StringCbLengthA(
  [in]  STRSAFE_PCNZCH psz,
  [in]  size_t         cbMax,
  [out] size_t         *pcbLength
);

매개 변수

[in] psz

형식: LPCTSTR

길이를 확인할 문자열입니다.

[in] cbMax

형식: size_t

종료 null 문자에 사용되는 바이트를 포함하여 psz에서 허용되는 최대 바이트 수입니다. 이 값은 를 초과 STRSAFE_MAX_CCH * sizeof(TCHAR)할 수 없습니다.

[out] pcbLength

형식: size_t*

종료 null 문자에 사용되는 바이트를 제외한 psz의 바이트 수입니다. 이 값은 pcb 가 NULL 이 아니고 함수가 성공한 경우에만 유효합니다.

반환 값

형식: HRESULT

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

반환 코드 Description
S_OK
 psz의 문자열이 NULL이 아니고 문자열의 길이(종료 null 문자 포함)가 cbMax 문자보다 작거나 같습니다.
STRSAFE_E_INVALID_PARAMETER
 psz의 값은 NULL, cbMax는 보다 STRSAFE_MAX_CCH * sizeof(TCHAR)크거나 psz는 cbMax보다 깁니다.
 

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

설명

대체되는 함수에 비해 StringCbLength 는 코드에서 적절한 버퍼 처리를 위한 추가 도구입니다. 버퍼 처리 불량은 버퍼 오버런과 관련된 많은 보안 문제에 연루됩니다.

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

문자열 데이터 형식 문자열 리터럴 함수
char "문자열" StringCbLengthA
TCHAR TEXT("string") StringCbLength
Wchar L"string" StringCbLengthW
 

UnalignedStringCbLength 는 이 함수의 별칭입니다.

참고

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

요구 사항

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

추가 정보

StringCchLength