StringCbGetsW 함수(strsafe.h)
줄 바꿈 문자('\n')를 포함하여 stdin에서 한 줄의 텍스트를 가져옵니다. 텍스트 줄이 대상 버퍼에 복사되고 줄 바꿈 문자가 null 문자로 바뀝니다. 대상 버퍼의 크기는 이 버퍼의 끝을 지나서 작성되지 않도록 함수에 제공됩니다.
구문
STRSAFEAPI StringCbGetsW(
[out] STRSAFE_LPWSTR pszDest,
[in] size_t cbDest
);
매개 변수
[out] pszDest
형식: LPTSTR
입력을 수신하는 대상 버퍼입니다.
[in] cbDest
형식: size_t
대상 버퍼의 크기(바이트)입니다. 이 값은 함수가 성공하려면 보다 sizeof(TCHAR)
커야 합니다. 허용되는 최대 바이트 수는 입니다 STRSAFE_MAX_CCH * sizeof(TCHAR)
.
cbDest가 너무 작아서 전체 텍스트 줄을 보유하지 못하면 데이터가 잘립니다.
반환 값
형식: HRESULT
이 함수는 다음 값 중 하나를 반환할 수 있습니다. SUCCEEDED 및 FAILED 매크로를 사용하여 이 함수의 반환 값을 테스트하는 것이 좋습니다.
반환 코드 | Description |
---|---|
|
데이터가 stdin에서 읽혀지고 pszDest에서 버퍼에 복사되었으며 버퍼가 null로 종료되었습니다. |
|
오류 또는 파일 끝 조건을 나타냅니다. feof 또는 ferror를 사용하여 발생한 작업을 확인합니다. |
|
cbDest의 값이 허용되는 최대 값보다 큽니다. |
|
cbDest의 값은 이하입니다sizeof(TCHAR) .
|
이 함수는 대체되는 함수와 달리 HRESULT 값을 반환합니다.
설명
StringCbGets 는 코드에서 적절한 버퍼 처리를 위한 추가 처리를 제공합니다. 버퍼 처리 불량은 버퍼 오버런과 관련된 많은 보안 문제에 연루됩니다. StringCbGets 는 항상 null 길이가 아닌 대상 버퍼를 종료합니다.
pszDest 값은 NULL이 아니어야 합니다. null 문자열 포인터 값을 처리해야 하는 경우 StringCbGetsEx 를 참조하세요.
StringCbGets 는 제네릭 형식 또는 보다 구체적인 형식으로 사용할 수 있습니다. 문자열의 데이터 형식은 다음 표와 같이 사용해야 하는 이 함수의 형식을 결정합니다.
문자열 데이터 형식 | 문자열 리터럴 | 함수 |
---|---|---|
char | "문자열" | StringCbGetsA |
TCHAR | TEXT("string") | StringCbGets |
Wchar | L"string" | StringCbGetsW |
참고
strsafe.h 헤더는 STRINGCbGets를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | WINDOWS Server 2003 SP1 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | strsafe.h |
추가 정보
참조