RtlUnicodeStringInit 함수(ntstrsafe.h)

RtlUnicodeStringInit 함수는 UNICODE_STRING 구조를 초기화합니다.

통사론

NTSTRSAFEDDI RtlUnicodeStringInit(
  [out]          PUNICODE_STRING  DestinationString,
  [in, optional] NTSTRSAFE_PCWSTR pszSrc
);

매개 변수

[out] DestinationString

초기화할 UNICODE_STRING 구조체에 대한 포인터입니다. pszSrc 포인터는 DestinationString 매개 변수의 UNICODE_STRING 구조로 복사됩니다. pszSrc 가리키는 문자열의 최대 문자 수는 NTSTRSAFE_UNICODE_STRING_MAX_CCH.

[in, optional] pszSrc

선택적. null로 끝나는 문자열 상수에 대한 포인터입니다. 이 문자열 포인터는 DestinationString 매개 변수가 가리키는 UNICODE_STRING 구조체의 Buffer 멤버에 복사됩니다. 이 문자열 포인터는 NULL수 있습니다.

반환 값

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

반환 코드	묘사
STATUS_SUCCESS	이 성공 상태는 원본 데이터가 있고 문자열이 잘림 없이 복사되었으며 결과 대상 버퍼가 null로 종료됨을 의미합니다.
STATUS_INVALID_PARAMETER	이 오류 상태는 함수가 잘못된 입력 매개 변수를 수신했음을 의미합니다. 자세한 내용은 다음 목록을 참조하세요.

 

RtlUnicodeStringInit 다음 중 하나가 발생하면 STATUS_INVALID_PARAMETER 값을 반환합니다.

• pszSrc 매개 변수가 가리키는 문자열의 길이가 NTSTRSAFE_UNICODE_STRING_MAX_CCH 문자보다 큽니다.
• DestinationString 포인터는 NULL있지만 pszSrc 포인터는 NULL않습니다.

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

발언

RtlUnicodeStringInit 함수는 다음을 수행합니다.

• pszSrc 매개 변수가 가리키는 UNICODE_STRING 구조체의 Length 멤버를 pszSrc 매개 변수가 가리키는 문자열의 길이(바이트)로 설정합니다.
• UNICODE_STRING 구조체의 MaximumLength 멤버를 pszSrc 매개 변수가 가리키는 문자열의 길이(바이트)와 2바이트 단위로 설정합니다.
• UNICODE_STRING 구조체의 Buffer 멤버를 pszSrc 매개 변수가 지정하는 주소로 설정합니다.

DestinationString 포인터는 NULL않아야 합니다. NULLDestinationString 포인터 값을 지정해야 하는 경우 RtlUnicodeStringInitEx 함수를 사용합니다.

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

요구 사항

요구	값
지원되는 최소 클라이언트	SP1(서비스 팩 1)을 사용하여 Windows XP부터 사용할 수 있습니다.
대상 플랫폼	바탕 화면
헤더	ntstrsafe.h(Ntstrsafe.h 포함)
라이브러리	Ntstrsafe.lib
IRQL	조작되는 문자열이 항상 메모리에 상주하는 경우, 그렇지 않으면 PASSIVE_LEVEL

참고 항목

rtlUnicodeStringInitEx

UNICODE_STRING