RtlCopyUnicodeString 함수(wdm.h)
RtlCopyUnicodeString 루틴은 원본 문자열을 대상 문자열에 복사합니다.
구문
NTSYSAPI VOID RtlCopyUnicodeString(
[in, out] PUNICODE_STRING DestinationString,
[in, optional] PCUNICODE_STRING SourceString
);
매개 변수
[in, out] DestinationString
대상 문자열 버퍼에 대한 포인터입니다. 이 매개 변수는 UNICODE_STRING 구조를 가리킵니다.
[in, optional] SourceString
원본 문자열 버퍼에 대한 포인터입니다. 이 매개 변수는 UNICODE_STRING 구조를 가리킵니다.
반환 값
없음
설명
SourceString이 NULL인 경우 이 루틴은 DestinationString이 가리키는 구조체의 길이 필드를 0으로 설정합니다.
이 루틴은 DestinationString에서 가리키는 구조체의 MaximumLength 및 버퍼 필드를 수정하지 않습니다.
원본 문자열에서 복사한 바이트 수는 원본 문자열 길이(SourceString이 가리키는 구조체의 Length 멤버로 지정됨) 또는 대상 문자열의 최대 길이(DestinationString이 가리키는 구조의 MaximumLength 멤버에 의해 지정됨)입니다.
호출자는 RtlCopyUnicodeString을 호출하기 전에 DestinationString이 가리키는 구조체의 모든 멤버를 올바르게 초기화해야 합니다. 이 루틴을 호출하기 전에 Length 또는 MaximumLength 멤버를 초기화하지 못하면 버퍼 오버런이 발생할 수 있습니다.
호출자가 IRQL >= DISPATCH_LEVEL 실행 중인 경우 DestinationString 및 SourceString 버퍼가 상주해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe(커널 모드); Ntdll.dll(사용자 모드) |
| IRQL | 모든 수준(설명 섹션 참조) |