This topic has not yet been rated - Rate this topic

GetLengthSid function

Applies to: desktop apps only

The GetLengthSid function returns the length, in bytes, of a valid security identifier (SID).

Syntax

DWORD WINAPI GetLengthSid(
  __in  PSID pSid
);

Parameters

pSid [in]

A pointer to the SID structure whose length is returned. The structure is assumed to be valid.

Return value

If the SID structure is valid, the return value is the length, in bytes, of the SID structure.

If the SID structure is not valid, the return value is undefined. Before calling GetLengthSid, pass the SID to the IsValidSid function to verify that the SID is valid.

Examples

For an example that uses this function, see Getting the Logon SID.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Header

Winbase.h (include Windows.h)

Library

Advapi32.lib

DLL

Advapi32.dll

See also

Access Control Overview
Basic Access Control Functions
GetSidLengthRequired
GetSidSubAuthorityCount
IsValidSid
SID

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ