RtlUnicodeStringCbCatStringNEx 함수(ntstrsafe.h)

RtlUnicodeStringCbCatStringNEx 함수는 대상 문자열이 UNICODE_STRING 구조에 포함될 때 추가된 문자열의 크기를 제한하면서 두 문자열을 연결합니다.

구문

NTSTRSAFEDDI RtlUnicodeStringCbCatStringNEx(
  [in, out]       PUNICODE_STRING  DestinationString,
  [in]            NTSTRSAFE_PCWSTR pszSrc,
  [in]            size_t           cbToAppend,
  [out, optional] PUNICODE_STRING  RemainingString,
  [in]            DWORD            dwFlags
);

매개 변수

[in, out] DestinationString

선택 사항입니다. UNICODE_STRING 구조체에 대한 포인터입니다. 이 구조체에는 입력에 원본 문자열이 연결될 대상 문자열이 포함된 버퍼가 포함됩니다. 출력에서 이 버퍼는 전체 결과 문자열을 포함하는 대상 버퍼입니다. 원본 문자열(종료 null 제외)이 대상 문자열의 끝에 추가됩니다. 구조체의 문자열 버퍼에 있는 최대 바이트 수는 입니다 NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR). DestinationString 은 NULL일 수 있지만 dwFlags에서 STRSAFE_IGNORE_NULLS 설정된 경우에만 가능합니다.

[in] pszSrc

null로 끝나는 문자열에 대한 호출자 제공 포인터입니다. 이 문자열은 DestinationString이 가리키는 UNICODE_STRING 구조체에 포함된 문자열의 끝에 연결됩니다. pszSrc는 NULL일 수 있지만 dwFlags에서 STRSAFE_IGNORE_NULLS 설정된 경우에만 가능합니다.

[in] cbToAppend

DestinationString 매개 변수가 설명하는 문자열에 추가할 최대 바이트 수입니다.

[out, optional] RemainingString

선택 사항입니다. 호출자가 UNICODE_STRING 구조체에 NULL이 아닌 포인터를 제공하는 경우 함수는 이 구조체의 Buffer 멤버를 연결된 문자열의 끝으로 설정하고, 구조체의 Length 멤버를 0으로 설정하고, 구조체의 MaximumLength 멤버를 대상 버퍼에 남아 있는 바이트 수로 설정합니다. RemainingString 은 NULL일 수 있지만 dwFlags에서 STRSAFE_IGNORE_NULLS 설정된 경우에만 가능합니다.

[in] dwFlags

하나 이상의 플래그 및 선택적으로 채우기 바이트입니다. 플래그는 다음과 같이 정의됩니다.

반환 값

RtlUnicodeStringCbCatStringNEx 는 다음 NTSTATUS 값 중 하나를 반환합니다.

RtlUnicodeStringCbCatStringNEx 는 다음 중 하나가 발생할 때 STATUS_INVALID_PARAMETER 값을 반환합니다.

• UNICODE_STRING 구조체의 내용이 잘못되었습니다.
• 잘못된 플래그가 dwFlags에 지정되었습니다.
• 대상 버퍼가 이미 가득 찼습니다.
• 버퍼 포인터가 NULL 이고 STRSAFE_IGNORE_NULLS 플래그가 지정되지 않았습니다.
• 대상 버퍼 포인터는 NULL이지만 버퍼 크기는 0이 아닙니다.
• 대상 버퍼 포인터가 NULL이거나 길이가 0이지만 길이가 0이 아닌 원본 문자열이 있습니다.
• cbToAppend 매개 변수의 값이 보다 NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR)큽니다.

NTSTATUS 값을 테스트하는 방법에 대한 자세한 내용은 NTSTATUS 값 사용을 참조하세요.

설명

**RtlUnicodeStringCbCatStringNEx **함수는 대상 버퍼의 크기를 사용하여 연결 작업이 버퍼의 끝을 지나서 작성되지 않도록 합니다. 기본적으로 함수는 null 문자 값(즉, 0)으로 결과 문자열을 종료 하지 않습니다. 옵션으로 호출자는 STRSAFE_FILL_BEHIND 플래그와 0의 채우기 바이트 값을 사용하여 전체 대상 버퍼를 차지하지 않는 결과 문자열을 null로 종료할 수 있습니다.

RtlUnicodeStringCbCatStringNEx는 대상 문자열의 끝과 해당 문자열에서 사용되지 않은 바이트 수를 식별하는 UNICODE_STRING 구조를 반환하여 RtlUnicodeStringCbCatStringN 함수의 기능을 추가합니다. 추가 제어를 위해 RtlUnicodeStringCbCatStringNEx 에 플래그를 전달할 수 있습니다.

원본 문자열과 대상 문자열이 겹치면 함수의 동작이 정의되지 않습니다.

dwFlags에서 STRSAFE_IGNORE_NULLS 플래그를 설정하지 않으면 pszSrc 및 DestinationString 포인터는 NULL일 수 없습니다. STRSAFE_IGNORE_NULLS 설정된 경우 이러한 포인터 중 하나 또는 둘 다 NULL일 수 있습니다. DestinationString 포인터가 NULL인 경우 pszSrc 포인터는 NULL이거나 빈 문자열을 가리킵니다.

안전한 문자열 함수에 대한 자세한 내용은 안전한 문자열 함수 사용을 참조하세요.

요구 사항

추가 정보

• RtlUnicodeStringCbCatStringN
• RtlUnicodeStringCchCatStringNEx
• UNICODE_STRING