[New - Windows NT]
The BuildTrusteeWithSid function initializes a TRUSTEE structure. The caller specifies the security identifier (SID) of the trustee. The function sets other members of the structure to default values. The function does not look up the name associated with the SID.
VOID BuildTrusteeWithName(
| PTRUSTEE pTrustee, | // pointer to the structure to initialize |
| PSID pSid | // name of the trustee to put in the structure |
| ); |
Parameters
pTrustee
Pointer to a TRUSTEE structure to initialize. The BuildTrusteeWithSid function does not allocate any memory. If this parameter is NULL, the function does nothing.
pSid
Pointer to a SID that identifies the trustee. The BuildTrusteeWithSid function assigns this pointer to the ptstrName member of the TRUSTEE structure. The function sets the other members of the TRUSTEE structure as follows:
| Member | Value |
| pMultipleTrustee | NULL |
| MultipleTrusteeOperation | NO_MULTIPLE_TRUSTEE |
| TrusteeForm | TRUSTEE_IS_SID |
| TrusteeType | TRUSTEE_IS_UNKNOWN |
Return Values
None.
See Also