GetTrusteeName

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

LPTSTR GetTrusteeName(
  PTRUSTEE pTrustee  // trustee structure
);

Parameters

pTrustee

[in] Pointer to a TRUSTEE structure.

Return Values

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

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Header: Declared in Aclapi.h.
  Library: Use Advapi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Access Control Overview, Access Control Functions, TRUSTEE, SID