BuildTrusteeWithSid

[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

BuildTrusteeWithName, TRUSTEE