GetTrusteeNameA function

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

Syntax

LPSTR GetTrusteeNameA(
  PTRUSTEE_A pTrustee
);

Parameters

pTrustee

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]
Target Platform Windows
Header aclapi.h
Library Advapi32.lib
DLL Advapi32.dll

See Also

Access Control Overview

Basic Access Control Functions

SID

TRUSTEE