Export (0) Print
Expand All
Expand Minimize

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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft