Export (0) Print
Expand All
Expand Minimize

UNICODE_STRING structure

The UNICODE_STRING structure is used by various Local Security Authority (LSA) functions to specify a Unicode string.

Syntax


typedef struct _LSA_UNICODE_STRING {
  USHORT Length;
  USHORT MaximumLength;
  PWSTR  Buffer;
} LSA_UNICODE_STRING, *PLSA_UNICODE_STRING, UNICODE_STRING, *PUNICODE_STRING;

Members

Length

Specifies the length, in bytes, of the string pointed to by the Buffer member, not including the terminating NULL character, if any.

Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP:  When the Length structure member is zero and the MaximumLength structure member is 1, the Buffer structure member can be an empty string or contain solely a null character. This behavior changed beginning with Windows Server 2008 R2 and Windows 7 with SP1.

MaximumLength

Specifies the total size, in bytes, of memory allocated for Buffer. Up to MaximumLength bytes may be written into the buffer without trampling memory.

Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP:  When the Length structure member is zero and the MaximumLength structure member is 1, the Buffer structure member can be an empty string or contain solely a null character. This behavior changed beginning with Windows Server 2008 R2 and Windows 7 with SP1.

Buffer

Pointer to a wide-character string. Note that the strings returned by the various LSA functions might not be null-terminated.

Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP:  When the Length structure member is zero and the MaximumLength structure member is 1, the Buffer structure member can be an empty string or contain solely a null character. This behavior changed beginning with Windows Server 2008 R2 and Windows 7 with SP1.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Subauth.h;
Ntsecapi.h on Windows Server 2003 and Windows XP

 

 

Community Additions

ADD
Show:
© 2014 Microsoft