RtlAppendUnicodeToString 함수(wdm.h)

  • 아티클

RtlAppendUnicodeToString 루틴은 제공된 유니코드 문자열을 버퍼링된 유니코드 문자열에 연결합니다.

구문

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

매개 변수

[in, out] Destination

버퍼링된 문자열에 대한 포인터입니다.

[in, optional] Source

대상 문자열에 추가할 null로 끝나는 문자열에 대한 포인터입니다.

반환 값

RtlAppendUnicodeToString 은 다음 중 하나를 반환할 수 있습니다.

반환 코드 설명
STATUS_SUCCESS
 원본 문자열이 대상 문자열에 성공적으로 추가되었으며 추가된 바이트를 포함하도록 대상 문자열 길이가 업데이트되었습니다.
STATUS_BUFFER_TOO_SMALL
 대상 문자열 버퍼가 너무 작아서 원본 문자열을 추가할 수 없으므로 대상 문자열 길이가 업데이트되지 않고 대상 문자열 버퍼의 내용이 변경되지 않습니다.

설명

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 설명 섹션을 참조하십시오.

추가 정보

RtlAppendUnicodeStringToString