RtlAppendUnicodeToString 함수(wdm.h)
RtlAppendUnicodeToString 루틴은 제공된 유니코드 문자열을 버퍼링된 유니코드 문자열에 연결합니다.
구문
NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
[in, out] PUNICODE_STRING Destination,
[in, optional] PCWSTR Source
);
매개 변수
[in, out] Destination
버퍼링된 문자열에 대한 포인터입니다.
[in, optional] Source
대상 문자열에 추가할 null로 끝나는 문자열에 대한 포인터입니다.
반환 값
RtlAppendUnicodeToString 은 다음 중 하나를 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
원본 문자열이 대상 문자열에 성공적으로 추가되었으며 추가된 바이트를 포함하도록 대상 문자열 길이가 업데이트되었습니다. |
|
대상 문자열 버퍼가 너무 작아서 원본 문자열을 추가할 수 없으므로 대상 문자열 길이가 업데이트되지 않고 대상 문자열 버퍼의 내용이 변경되지 않습니다. |
설명
RtlAppendUnicodeToString 은 원본 문자열을 대상 문자열의 끝에 추가합니다.
대상 버퍼가 원본 및 대상 문자열을 연결하여 발생하는 문자열을 포함할 만큼 충분히 크지 않은 경우(원본 문자열을 종료하는 null 문자를 포함하지 않음) 루틴은 STATUS_BUFFER_TOO_SMALL 반환하고 대상 문자열을 변경하지 않은 상태로 둡니다.
호출자가 IRQL >= DISPATCH_LEVEL 실행 중인 경우 대상 버퍼가 상주해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
대상 플랫폼 | 유니버설 |
헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h 포함) |
라이브러리 | NtosKrnl.lib |
DLL | NtosKrnl.exe(커널 모드); Ntdll.dll(사용자 모드) |
IRQL | 설명 섹션을 참조하십시오. |