UNICODE_STRING 구조체(subauth.h)

UNICODE_STRING 구조체는 다양한 LSA(로컬 보안 기관) 함수에서 유니코드 문자열을 지정하는 데 사용됩니다.

구문

typedef struct _UNICODE_STRING {
  USHORT Length;
  USHORT MaximumLength;
  PWSTR  Buffer;
} UNICODE_STRING, *PUNICODE_STRING;

멤버

Length

종결 NULL 문자(있는 경우)를 포함하지 않고 Buffer 멤버가 가리키는 문자열의 길이(바이트)를 지정합니다.

Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: Length 구조체 멤버가 0이고 MaximumLength 구조체 멤버가 1인 경우 Buffer 구조체 멤버는 빈 문자열이거나 null 문자만 포함할 수 있습니다. 이 동작은 Windows Server 2008 R2 및 Windows 7 SP1부터 변경되었습니다.

MaximumLength

Buffer에 할당된 메모리의 총 크기(바이트)를 지정합니다. 최대 MaximumLength 바이트는 메모리를 짓밟지 않고 버퍼에 기록될 수 있습니다.

Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: Length 구조체 멤버가 0이고 MaximumLength 구조체 멤버가 1인 경우 Buffer 구조체 멤버는 빈 문자열이거나 null 문자만 포함할 수 있습니다. 이 동작은 Windows Server 2008 R2 및 Windows 7 SP1부터 변경되었습니다.

Buffer

와이드 문자열에 대한 포인터입니다. 다양한 LSA 함수에서 반환된 문자열은 null로 종료되지 않을 수 있습니다.

Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: Length 구조체 멤버가 0이고 MaximumLength 구조체 멤버가 1인 경우 Buffer 구조체 멤버는 빈 문자열이거나 null 문자만 포함할 수 있습니다. 이 동작은 Windows Server 2008 R2 및 Windows 7 SP1부터 변경되었습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	subauth.h