RtlUnicodeStringValidate 함수(ntstrsafe.h)
RtlUnicodeStringValidate 함수는 UNICODE_STRING 구조체의 내용의 유효성을 검사합니다.
구문
NTSTRSAFEDDI RtlUnicodeStringValidate(
[in] PCUNICODE_STRING SourceString
);
매개 변수
[in] SourceString
유효성을 검사할 UNICODE_STRING 구조체에 대한 포인터입니다.
반환 값
RtlUnicodeStringValidate 는 다음 NTSTATUS 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
이 성공 상태 함수가 성공적으로 완료되었음을 의미합니다. |
|
이 오류 상태 함수가 잘못된 입력 매개 변수를 수신했음을 의미합니다. 자세한 내용은 다음 목록을 참조하세요. |
RtlUnicodeStringValidate 는 다음 중 하나가 발생하면 STATUS_INVALID_PARAMETER 값을 반환합니다.
- SourceString->길이 % sizeof(WCHAR)가 0과 같지 않습니다.
- SourceString->MaximumLength % sizeof(WCHAR)는 0이 아닙니다.
- SourceString->길이 가 SourceString->MaximumLength보다 큽니다.
- SourceString->MaximumLength 가 NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR)보다 큽니다.
- SourceString->버퍼 는 NULL 이지만 SourceString->Length 또는 SourceString->MaximumLength 는 0이 아닙니다.
설명
SourceString 포인터는 NULL일 수 없습니다. NULL 포인터 값을 지정해야 하는 경우 RtlUnicodeStringValidateEx 함수를 사용합니다.
안전한 문자열 함수에 대한 자세한 내용은 안전한 문자열 함수 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP에서 SP1(서비스 팩 1) 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ntstrsafe.h(Ntstrsafe.h 포함) |
| 라이브러리 | Ntstrsafe.lib |
| IRQL | 조작되는 문자열이 항상 메모리에 상주하는 경우 이고, 그렇지 않으면 PASSIVE_LEVEL |