Expand Minimize
This topic has not yet been rated - Rate this topic

GetTrusteeName function

The GetTrusteeName function retrieves the trustee name from the specified TRUSTEE structure.

Syntax


LPTSTR WINAPI GetTrusteeName(
  _In_  PTRUSTEE pTrustee
);

Parameters

pTrustee [in]

A pointer to a TRUSTEE structure.

Return value

If the TrusteeForm member of the TRUSTEE structure is TRUSTEE_IS_NAME, the return value is the pointer assigned to the ptstrName member of the structure.

If the TrusteeForm member is TRUSTEE_IS_SID, the return value is NULL. The function does not look up the name associated with a security identifier (SID).

Remarks

The GetTrusteeName function does not allocate any memory.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Aclapi.h

Library

Advapi32.lib

DLL

Advapi32.dll

Unicode and ANSI names

GetTrusteeNameW (Unicode) and GetTrusteeNameA (ANSI)

See also

Access Control Overview
Basic Access Control Functions
TRUSTEE
SID

 

 

Send comments about this topic to Microsoft

Build date: 10/26/2012

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.